mthds 0.0.7 → 0.0.8

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Evotis S.A.S.
+Copyright (c) 2026 Evotis S.A.S.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -10,6 +10,27 @@ A method is a packaged workflow that an AI agent (like Claude Code) can use. Met
 
 ## CLI Usage
 
+For the full CLI reference, see [CLI.md](./CLI.md).
+
+### Quick Start
+
+```bash
+# Set up the API runner (interactive — prompts for URL and key)
+mthds setup runner api
+
+# Or set up the pipelex runner (local)
+mthds setup runner pipelex
+
+# Run a pipeline
+mthds run pipe my_pipe_code
+
+# Validate a bundle
+mthds validate ./bundle.mthds
+
+# Install a method from the hub
+mthds install org/repo
+```
+
 ### Install a method
 
 ```bash
@@ -116,9 +137,28 @@ These are the only runners that exist today. Feel free to create your own runner
 npx mthds setup runner pipelex
 ```
 
-### Use the API runner
+### Configure the API runner
+
+The API runner is the default. Set it up interactively:
+
+```bash
+mthds setup runner api
+```
+
+This prompts for the API URL and API key (masked input) and saves them to `~/.mthds/credentials`.
+
+You can also set values directly:
+
+```bash
+mthds config set api-key YOUR_KEY
+mthds config set api-url https://your-api-instance.com
+```
+
+Credentials are stored in `~/.mthds/credentials` and shared between mthds-js and mthds-python.
+
+You can also use environment variables (`PIPELEX_API_KEY`, `PIPELEX_API_URL`) which take precedence over the credentials file.
 
-See the [SDK Usage](#sdk-usage) section below to connect to a Pipelex API instance.
+See the [SDK Usage](#sdk-usage) section below to connect to a Pipelex API instance programmatically.
 
 ## SDK Usage
 
@@ -165,11 +205,11 @@ Instead of passing options to the constructor, you can set environment variables
 
 | Variable | Description |
 |----------|-------------|
-| `MTHDS_API_BASE_URL` | Base URL of the API |
-| `MTHDS_API_KEY` | API authentication token |
+| `PIPELEX_API_URL` | Base URL of the API |
+| `PIPELEX_API_KEY` | API authentication token |
 
 ```typescript
-// Reads MTHDS_API_BASE_URL and MTHDS_API_KEY from the environment
+// Reads PIPELEX_API_URL and PIPELEX_API_KEY from the environment
 const client = new MthdsApiClient();
 ```
 
@@ -200,7 +240,7 @@ Anonymous usage data is collected to help rank methods on the leaderboard. Each
 To opt out:
 
 ```bash
-DISABLE_TELEMETRY=1 npx mthds install <slug>
+mthds telemetry disable
 ```
 
 ## Development

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

@@ -0,0 +1,35 @@
+/**
+ * Agent build subcommands — generate pipelines, runner code, inputs, and output schemas.
+ * Outputs JSON only.
+ */
+import type { RunnerType } from "../../runners/types.js";
+interface WithRunner {
+    runner?: RunnerType;
+    libraryDir?: string[];
+}
+export declare function agentBuildPipe(brief: string, options: {
+    output?: string;
+} & WithRunner): Promise<void>;
+export declare function agentBuildRunnerMethod(name: string, options: {
+    pipe?: string;
+    output?: string;
+} & WithRunner): Promise<void>;
+export declare function agentBuildRunnerPipe(target: string, options: {
+    pipe?: string;
+    output?: string;
+} & WithRunner): Promise<void>;
+export declare function agentBuildInputsMethod(name: string, options: {
+    pipe?: string;
+} & WithRunner): Promise<void>;
+export declare function agentBuildInputsPipe(target: string, options: {
+    pipe?: string;
+} & WithRunner): Promise<void>;
+export declare function agentBuildOutputMethod(name: string, options: {
+    pipe?: string;
+    format?: string;
+} & WithRunner): Promise<void>;
+export declare function agentBuildOutputPipe(target: string, options: {
+    pipe?: string;
+    format?: string;
+} & WithRunner): Promise<void>;
+export {};

package/dist/agent/commands/build.js

@@ -0,0 +1,334 @@
+/**
+ * Agent build subcommands — generate pipelines, runner code, inputs, and output schemas.
+ * Outputs JSON only.
+ */
+import { readFileSync, writeFileSync } 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 `build <subcommand>`, filtering out --runner, -L/--library-dir, and --log-level */
+function extractPassthroughArgs() {
+    const argv = process.argv;
+    const buildIdx = argv.indexOf("build");
+    if (buildIdx === -1)
+        return [];
+    const raw = argv.slice(buildIdx + 2); // skip "build" + subcommand
+    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; // skip flag + value
+        }
+        else if (raw[i].startsWith("--runner=") ||
+            raw[i].startsWith("--library-dir=") ||
+            raw[i].startsWith("--log-level=")) {
+            i += 1; // skip combined flag=value
+        }
+        else {
+            result.push(raw[i]);
+            i++;
+        }
+    }
+    return result;
+}
+// ── build pipe ────────────────────────────────────────────────────────
+export async function agentBuildPipe(brief, 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.buildPassthrough("pipe", extractPassthroughArgs());
+        }
+        catch (err) {
+            agentError(err.message, "RunnerError", {
+                error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+            });
+        }
+        return;
+    }
+    try {
+        const result = await runner.buildPipe({ brief, output: options.output });
+        if (result.mthds_content && options.output) {
+            writeFileSync(options.output, result.mthds_content, "utf-8");
+        }
+        agentSuccess({
+            success: result.success,
+            message: result.message,
+            mthds_content: result.mthds_content,
+            pipelex_bundle_blueprint: result.pipelex_bundle_blueprint,
+        });
+    }
+    catch (err) {
+        agentError(err.message, "RunnerError", {
+            error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+        });
+    }
+}
+// ── build runner method ──────────────────────────────────────────────
+export async function agentBuildRunnerMethod(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.buildPassthrough("runner", extractPassthroughArgs());
+        }
+        catch (err) {
+            agentError(err.message, "RunnerError", {
+                error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+            });
+        }
+        return;
+    }
+    agentError("Method target is not yet supported for the API runner. Use 'mthds-agent build runner pipe <target>' instead, or specify a different runner with --runner <name>.", "ArgumentError", { error_domain: AGENT_ERROR_DOMAINS.ARGUMENT });
+}
+// ── build runner pipe ────────────────────────────────────────────────
+export async function agentBuildRunnerPipe(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.buildPassthrough("runner", extractPassthroughArgs());
+        }
+        catch (err) {
+            agentError(err.message, "RunnerError", {
+                error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+            });
+        }
+        return;
+    }
+    if (!target.endsWith(".mthds")) {
+        agentError("build runner requires a .mthds bundle file as the target.", "ArgumentError", { error_domain: AGENT_ERROR_DOMAINS.ARGUMENT });
+    }
+    if (!options.pipe) {
+        agentError("--pipe is required when using the API runner.", "ArgumentError", {
+            error_domain: AGENT_ERROR_DOMAINS.ARGUMENT,
+        });
+    }
+    let mthdsContent;
+    try {
+        mthdsContent = readFileSync(target, "utf-8");
+    }
+    catch (err) {
+        agentError(`Cannot read bundle: ${err.message}`, "IOError", { error_domain: AGENT_ERROR_DOMAINS.IO });
+    }
+    try {
+        const result = await runner.buildRunner({
+            mthds_content: mthdsContent,
+            pipe_code: options.pipe,
+        });
+        if (options.output) {
+            writeFileSync(options.output, result.python_code, "utf-8");
+        }
+        agentSuccess({
+            success: result.success,
+            message: result.message,
+            python_code: result.python_code,
+            pipe_code: result.pipe_code,
+        });
+    }
+    catch (err) {
+        agentError(err.message, "RunnerError", {
+            error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+        });
+    }
+}
+// ── build inputs method ──────────────────────────────────────────────
+export async function agentBuildInputsMethod(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.buildPassthrough("inputs", extractPassthroughArgs());
+        }
+        catch (err) {
+            agentError(err.message, "RunnerError", {
+                error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+            });
+        }
+        return;
+    }
+    agentError("Method target is not yet supported for the API runner. Use 'mthds-agent build inputs pipe <target>' instead, or specify a different runner with --runner <name>.", "ArgumentError", { error_domain: AGENT_ERROR_DOMAINS.ARGUMENT });
+}
+// ── build inputs pipe ────────────────────────────────────────────────
+export async function agentBuildInputsPipe(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.buildPassthrough("inputs", extractPassthroughArgs());
+        }
+        catch (err) {
+            agentError(err.message, "RunnerError", {
+                error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+            });
+        }
+        return;
+    }
+    if (!options.pipe) {
+        agentError("--pipe is required when using the API runner.", "ArgumentError", {
+            error_domain: AGENT_ERROR_DOMAINS.ARGUMENT,
+        });
+    }
+    let mthdsContent;
+    try {
+        mthdsContent = readFileSync(target, "utf-8");
+    }
+    catch (err) {
+        agentError(`Cannot read bundle: ${err.message}`, "IOError", { error_domain: AGENT_ERROR_DOMAINS.IO });
+    }
+    try {
+        const result = await runner.buildInputs({
+            mthds_content: mthdsContent,
+            pipe_code: options.pipe,
+        });
+        agentSuccess({
+            success: true,
+            inputs: result,
+        });
+    }
+    catch (err) {
+        agentError(err.message, "RunnerError", {
+            error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+        });
+    }
+}
+// ── build output method ──────────────────────────────────────────────
+export async function agentBuildOutputMethod(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.buildPassthrough("output", extractPassthroughArgs());
+        }
+        catch (err) {
+            agentError(err.message, "RunnerError", {
+                error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+            });
+        }
+        return;
+    }
+    agentError("Method target is not yet supported for the API runner. Use 'mthds-agent build output pipe <target>' instead, or specify a different runner with --runner <name>.", "ArgumentError", { error_domain: AGENT_ERROR_DOMAINS.ARGUMENT });
+}
+// ── build output pipe ────────────────────────────────────────────────
+export async function agentBuildOutputPipe(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.buildPassthrough("output", extractPassthroughArgs());
+        }
+        catch (err) {
+            agentError(err.message, "RunnerError", {
+                error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+            });
+        }
+        return;
+    }
+    if (!options.pipe) {
+        agentError("--pipe is required when using the API runner.", "ArgumentError", {
+            error_domain: AGENT_ERROR_DOMAINS.ARGUMENT,
+        });
+    }
+    let mthdsContent;
+    try {
+        mthdsContent = readFileSync(target, "utf-8");
+    }
+    catch (err) {
+        agentError(`Cannot read bundle: ${err.message}`, "IOError", { error_domain: AGENT_ERROR_DOMAINS.IO });
+    }
+    const validFormats = ["json", "python", "schema"];
+    const format = (options.format ?? "schema");
+    if (!validFormats.includes(format)) {
+        agentError(`Invalid format "${format}". Must be one of: ${validFormats.join(", ")}`, "ArgumentError", { error_domain: AGENT_ERROR_DOMAINS.ARGUMENT });
+    }
+    try {
+        const result = await runner.buildOutput({
+            mthds_content: mthdsContent,
+            pipe_code: options.pipe,
+            format: format,
+        });
+        agentSuccess({
+            success: true,
+            output: result,
+        });
+    }
+    catch (err) {
+        agentError(err.message, "RunnerError", {
+            error_domain: AGENT_ERROR_DOMAINS.RUNNER,
+        });
+    }
+}
+//# sourceMappingURL=build.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Agent config commands — manage configuration with JSON output.
+ */
+export declare function agentConfigSet(cliKey: string, value: string): Promise<void>;
+export declare function agentConfigGet(cliKey: string): Promise<void>;
+export declare function agentConfigList(): Promise<void>;

package/dist/agent/commands/config.js

@@ -0,0 +1,50 @@
+/**
+ * Agent config commands — manage configuration with JSON output.
+ */
+import { agentSuccess, agentError, AGENT_ERROR_DOMAINS } from "../output.js";
+import { VALID_KEYS, resolveKey, getConfigValue, setConfigValue, listConfig, } from "../../config/config.js";
+import { RUNNER_NAMES } from "../../runners/types.js";
+function isValidUrl(s) {
+    try {
+        new URL(s);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function agentConfigSet(cliKey, value) {
+    const configKey = resolveKey(cliKey);
+    if (!configKey) {
+        agentError(`Unknown config key: ${cliKey}. Valid keys: ${VALID_KEYS.join(", ")}`, "ConfigError", { error_domain: AGENT_ERROR_DOMAINS.CONFIG });
+    }
+    if (configKey === "runner" && !RUNNER_NAMES.includes(value)) {
+        agentError(`Invalid runner: ${value}. Valid runners: ${RUNNER_NAMES.join(", ")}`, "ConfigError", { error_domain: AGENT_ERROR_DOMAINS.CONFIG });
+    }
+    if (configKey === "apiUrl" && !isValidUrl(value)) {
+        agentError(`Invalid URL: ${value}`, "ConfigError", {
+            error_domain: AGENT_ERROR_DOMAINS.CONFIG,
+        });
+    }
+    setConfigValue(configKey, value);
+    agentSuccess({ success: true, key: cliKey, value });
+}
+export async function agentConfigGet(cliKey) {
+    const configKey = resolveKey(cliKey);
+    if (!configKey) {
+        agentError(`Unknown config key: ${cliKey}. Valid keys: ${VALID_KEYS.join(", ")}`, "ConfigError", { error_domain: AGENT_ERROR_DOMAINS.CONFIG });
+    }
+    const { value, source } = getConfigValue(configKey);
+    agentSuccess({ key: cliKey, value, source });
+}
+export async function agentConfigList() {
+    const entries = listConfig();
+    agentSuccess({
+        config: entries.map((e) => ({
+            key: e.cliKey,
+            value: e.value,
+            source: e.source,
+        })),
+    });
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/agent/commands/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EACL,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,GACX,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,KAAa;IAEb,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,UAAU,CACR,uBAAuB,MAAM,iBAAiB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACrE,aAAa,EACb,EAAE,YAAY,EAAE,mBAAmB,CAAC,MAAM,EAAE,CAC7C,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAmB,CAAC,EAAE,CAAC;QAC1E,UAAU,CACR,mBAAmB,KAAK,oBAAoB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACrE,aAAa,EACb,EAAE,YAAY,EAAE,mBAAmB,CAAC,MAAM,EAAE,CAC7C,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,UAAU,CAAC,gBAAgB,KAAK,EAAE,EAAE,aAAa,EAAE;YACjD,YAAY,EAAE,mBAAmB,CAAC,MAAM;SACzC,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc;IACjD,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,UAAU,CACR,uBAAuB,MAAM,iBAAiB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACrE,aAAa,EACb,EAAE,YAAY,EAAE,mBAAmB,CAAC,MAAM,EAAE,CAC7C,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IACpD,YAAY,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,YAAY,CAAC;QACX,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1B,GAAG,EAAE,CAAC,CAAC,MAAM;YACb,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * Non-interactive agent install command.
+ * All choices are required CLI flags — no prompts, no clack.
+ */
+interface AgentInstallOptions {
+    local?: string;
+    agent?: string;
+    location?: string;
+    method?: string;
+    skills?: boolean;
+    noRunner?: boolean;
+}
+export declare function agentInstall(address: string | undefined, options: AgentInstallOptions): Promise<void>;
+export {};