mthds 0.0.2 → 0.0.4

package/README.md

@@ -1,12 +1,14 @@
 # mthds
 
-CLI for installing and managing **methods** — reusable workflows for AI coding agents.
+CLI and SDK for **methods** — reusable workflows for AI coding agents.
 
 ## What is a method?
 
 A method is a packaged workflow that an AI agent (like Claude Code) can use. Methods are stored in a registry and installed locally via their unique slug.
 
-## Install a method
+## CLI Usage
+
+### Install a method
 
 ```bash
 npx mthds install <slug>
@@ -27,7 +29,7 @@ The CLI will:
 | Local | `<cwd>/.claude/methods/<slug>/` |
 | Global | `~/.claude/methods/<slug>/` |
 
-## Install software runtime
+### Install software runtime
 
 ```bash
 npx mthds setup software pipelex
@@ -35,6 +37,81 @@ npx mthds setup software pipelex
 
 Installs [uv](https://docs.astral.sh/uv/) and [pipelex](https://pipelex.dev) so methods that depend on them can run.
 
+## SDK Usage
+
+Install the package:
+
+```bash
+npm install mthds
+```
+
+### Basic example
+
+```typescript
+import { MthdsApiClient } from "mthds";
+
+const client = new MthdsApiClient({
+  apiBaseUrl: "https://api.pipelex.com",
+  apiToken: "your-api-key",
+});
+
+const result = await client.executePipeline({
+  pipe_code: "my-pipeline",
+  inputs: {
+    topic: "quantum computing",
+  },
+});
+
+console.log(result.pipe_output);
+```
+
+The hosted API at `https://api.pipelex.com` is coming soon. In the meantime, you can run the API yourself.
+
+### Self-hosted API
+
+Point the client to your own server:
+
+```typescript
+const client = new MthdsApiClient({
+  apiBaseUrl: "http://localhost:8081",
+  apiToken: "your-api-key",
+});
+```
+
+### Environment variables
+
+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 |
+
+```typescript
+// Reads MTHDS_API_BASE_URL and MTHDS_API_KEY from the environment
+const client = new MthdsApiClient();
+```
+
+### Methods
+
+| Method | Description |
+|--------|-------------|
+| `executePipeline(options)` | Execute a pipeline and wait for the result |
+| `startPipeline(options)` | Start a pipeline asynchronously |
+
+### Pipeline options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `pipe_code` | `string` | Pipeline code to execute |
+| `mthds_content` | `string` | Raw method content (alternative to `pipe_code`) |
+| `inputs` | `Record<string, string \| string[] \| object>` | Pipeline input variables |
+| `output_name` | `string` | Name of the output to return |
+| `output_multiplicity` | `boolean \| number` | Expected output multiplicity |
+| `dynamic_output_concept_code` | `string` | Dynamic output concept code |
+
+Either `pipe_code` or `mthds_content` must be provided.
+
 ## Telemetry
 
 Anonymous usage data (method slug + timestamp) is collected to help rank methods on the leaderboard. No personal or device information is collected.

package/dist/cli.js

@@ -7,6 +7,13 @@ import { printLogo } from "./commands/index.js";
 import { installRunner } from "./commands/setup.js";
 import { installMethod } from "./commands/install.js";
 import { configSet, configGet, configList } from "./commands/config.js";
+import { runPipeline } from "./commands/run.js";
+import { buildPipe, buildRunner, buildInputs, buildOutput, } from "./commands/build.js";
+import { validatePlx } from "./commands/validate.js";
+import { runnerSetDefault, runnerList } from "./commands/runner.js";
+function getRunner(cmd) {
+    return cmd.optsWithGlobals().runner;
+}
 const require = createRequire(import.meta.url);
 const pkg = require("../package.json");
 const program = new Command();
@@ -14,12 +21,81 @@ program
     .name("mthds")
     .version(pkg.version)
     .description("CLI bridge to the Pipelex runtime")
+    .option("--runner <type>", "Runner to use (api, pipelex)")
     .exitOverride()
     .configureOutput({
     writeOut: () => { },
     writeErr: () => { },
 });
-// mthds install <slug>
+// ── mthds run <target> ─────────────────────────────────────────────
+program
+    .command("run")
+    .argument("<target>", "Pipe code or .plx bundle file")
+    .option("--pipe <code>", "Pipe code (when target is a bundle)")
+    .option("-i, --inputs <file>", "Path to JSON inputs file")
+    .option("-o, --output <file>", "Path to save output JSON")
+    .option("--no-output", "Skip saving output to file")
+    .option("--no-pretty-print", "Skip pretty printing the output")
+    .description("Execute a pipeline")
+    .exitOverride()
+    .action(async (target, options, cmd) => {
+    await runPipeline(target, { ...options, runner: getRunner(cmd) });
+});
+// ── mthds build <subcommand> ────────────────────────────────────────
+const build = program
+    .command("build")
+    .description("Generate pipelines, runner code, inputs, and output schemas")
+    .exitOverride();
+build
+    .command("pipe")
+    .argument("<brief>", "Natural-language description of the pipeline")
+    .option("-o, --output <file>", "Path to save the generated .plx file")
+    .description("Build a pipeline from a prompt")
+    .exitOverride()
+    .action(async (brief, options, cmd) => {
+    await buildPipe(brief, { ...options, runner: getRunner(cmd) });
+});
+build
+    .command("runner")
+    .argument("<target>", ".plx bundle file")
+    .option("--pipe <code>", "Pipe code to generate runner for")
+    .option("-o, --output <file>", "Path to save the generated Python file")
+    .description("Generate Python runner code for a pipe")
+    .exitOverride()
+    .action(async (target, options, cmd) => {
+    await buildRunner(target, { ...options, runner: getRunner(cmd) });
+});
+build
+    .command("inputs")
+    .argument("<target>", ".plx bundle file")
+    .requiredOption("--pipe <code>", "Pipe code to generate inputs for")
+    .description("Generate example input JSON for a pipe")
+    .exitOverride()
+    .action(async (target, options, cmd) => {
+    await buildInputs(target, { ...options, runner: getRunner(cmd) });
+});
+build
+    .command("output")
+    .argument("<target>", ".plx bundle file")
+    .requiredOption("--pipe <code>", "Pipe code to generate output for")
+    .option("--format <format>", "Output format (json, python, schema)", "schema")
+    .description("Generate output representation for a pipe")
+    .exitOverride()
+    .action(async (target, options, cmd) => {
+    await buildOutput(target, { ...options, runner: getRunner(cmd) });
+});
+// ── mthds validate <target> ────────────────────────────────────────
+program
+    .command("validate")
+    .argument("<target>", ".plx bundle file or pipe code")
+    .option("--pipe <code>", "Pipe code that must exist in the bundle")
+    .option("--bundle <file>", "Bundle file path (alternative to positional)")
+    .description("Validate PLX content")
+    .exitOverride()
+    .action(async (target, options, cmd) => {
+    await validatePlx(target, { ...options, runner: getRunner(cmd) });
+});
+// ── mthds install <slug> ───────────────────────────────────────────
 program
     .command("install")
     .argument("<slug>", "Method slug to install")
@@ -28,7 +104,7 @@ program
     .action(async (slug) => {
     await installMethod(slug);
 });
-// mthds setup runner <name>
+// ── mthds setup runner <name> ──────────────────────────────────────
 const setup = program.command("setup").exitOverride();
 setup
     .command("runner <name>")
@@ -37,7 +113,27 @@ setup
     .action(async (name) => {
     await installRunner(name);
 });
-// mthds config set|get|list
+// ── mthds runner set-default|list ───────────────────────────────────
+const runnerCmd = program
+    .command("runner")
+    .description("Manage runners")
+    .exitOverride();
+runnerCmd
+    .command("set-default")
+    .argument("<name>", "Runner name (api, pipelex)")
+    .description("Set the default runner")
+    .exitOverride()
+    .action(async (name) => {
+    await runnerSetDefault(name);
+});
+runnerCmd
+    .command("list")
+    .description("List available runners")
+    .exitOverride()
+    .action(async () => {
+    await runnerList();
+});
+// ── mthds config set|get|list ──────────────────────────────────────
 const config = program.command("config").description("Manage configuration").exitOverride();
 config
     .command("set")
@@ -80,7 +176,13 @@ program.parseAsync(process.argv).catch((err) => {
             .replace(/^Error: /, "");
         p.log.error(message);
         if (err.code === "commander.missingArgument") {
-            p.log.info("Run mthds --help to see usage.");
+            const args = process.argv.slice(2);
+            if (args.includes("runner") && args.includes("set-default")) {
+                p.log.info("Run mthds runner list to see available runners.");
+            }
+            else {
+                p.log.info("Run mthds --help to see usage.");
+            }
         }
         p.outro("");
         process.exit(1);

package/dist/cli.js.map

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

package/dist/client/client.d.ts

@@ -0,0 +1,15 @@
+import type { RunnerProtocol } from "./protocol.js";
+import type { ExecutePipelineOptions, PipelineExecuteResponse, PipelineStartResponse } from "./pipeline.js";
+interface MthdsApiClientOptions {
+    apiToken?: string;
+    apiBaseUrl?: string;
+}
+export declare class MthdsApiClient implements RunnerProtocol {
+    private readonly apiToken;
+    private readonly apiBaseUrl;
+    constructor(options?: MthdsApiClientOptions);
+    private makeApiCall;
+    executePipeline(options: ExecutePipelineOptions): Promise<PipelineExecuteResponse>;
+    startPipeline(options: ExecutePipelineOptions): Promise<PipelineStartResponse>;
+}
+export {};

package/dist/client/client.js

@@ -0,0 +1,64 @@
+import { ClientAuthenticationError, PipelineRequestError, } from "./exceptions.js";
+export class MthdsApiClient {
+    apiToken;
+    apiBaseUrl;
+    constructor(options = {}) {
+        this.apiToken = options.apiToken ?? process.env.MTHDS_API_KEY;
+        const resolvedBaseUrl = options.apiBaseUrl ?? process.env.MTHDS_API_BASE_URL;
+        if (!resolvedBaseUrl) {
+            throw new ClientAuthenticationError("API base URL is required for API execution");
+        }
+        this.apiBaseUrl = resolvedBaseUrl.replace(/\/+$/, "");
+    }
+    async makeApiCall(endpoint, pipelineRequest) {
+        const url = `${this.apiBaseUrl}/${endpoint}`;
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (this.apiToken) {
+            headers["Authorization"] = `Bearer ${this.apiToken}`;
+        }
+        const response = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(pipelineRequest),
+            signal: AbortSignal.timeout(1_200_000),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => "");
+            throw new PipelineRequestError(`API POST /${endpoint} failed (${response.status}): ${text || response.statusText}`);
+        }
+        return response.json();
+    }
+    async executePipeline(options) {
+        if (!options.pipe_code && !options.mthds_content) {
+            throw new PipelineRequestError("Either pipe_code or mthds_content must be provided to executePipeline.");
+        }
+        const request = {
+            pipe_code: options.pipe_code,
+            mthds_content: options.mthds_content,
+            inputs: options.inputs,
+            output_name: options.output_name,
+            output_multiplicity: options.output_multiplicity,
+            dynamic_output_concept_code: options.dynamic_output_concept_code,
+        };
+        const data = await this.makeApiCall("api/v1/pipeline/execute", request);
+        return data;
+    }
+    async startPipeline(options) {
+        if (!options.pipe_code && !options.mthds_content) {
+            throw new PipelineRequestError("Either pipe_code or mthds_content must be provided to startPipeline.");
+        }
+        const request = {
+            pipe_code: options.pipe_code,
+            mthds_content: options.mthds_content,
+            inputs: options.inputs,
+            output_name: options.output_name,
+            output_multiplicity: options.output_multiplicity,
+            dynamic_output_concept_code: options.dynamic_output_concept_code,
+        };
+        const data = await this.makeApiCall("api/v1/pipeline/start", request);
+        return data;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

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

package/dist/client/exceptions.d.ts

@@ -0,0 +1,6 @@
+export declare class ClientAuthenticationError extends Error {
+    constructor(message: string);
+}
+export declare class PipelineRequestError extends Error {
+    constructor(message: string);
+}

package/dist/client/exceptions.js

@@ -0,0 +1,13 @@
+export class ClientAuthenticationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ClientAuthenticationError";
+    }
+}
+export class PipelineRequestError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PipelineRequestError";
+    }
+}
+//# sourceMappingURL=exceptions.js.map

package/dist/client/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../src/client/exceptions.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/client/index.d.ts

@@ -0,0 +1,5 @@
+export { MthdsApiClient } from "./client.js";
+export type { RunnerProtocol } from "./protocol.js";
+export { ClientAuthenticationError, PipelineRequestError, } from "./exceptions.js";
+export type { PipelineState, PipelineRequest, PipelineExecuteResponse, PipelineStartResponse, ExecutePipelineOptions, } from "./pipeline.js";
+export type { DictStuff, DictWorkingMemory, DictPipeOutput, VariableMultiplicity, StuffContentOrData, PipelineInputs, } from "./models/index.js";

package/dist/client/index.js

@@ -0,0 +1,3 @@
+export { MthdsApiClient } from "./client.js";
+export { ClientAuthenticationError, PipelineRequestError, } from "./exceptions.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,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/client/models/index.d.ts

@@ -0,0 +1,4 @@
+export type { DictStuff } from "./stuff.js";
+export type { DictWorkingMemory } from "./working_memory.js";
+export type { DictPipeOutput, VariableMultiplicity } from "./pipe_output.js";
+export type { StuffContentOrData, PipelineInputs } from "./pipeline_inputs.js";

package/dist/client/models/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/client/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/models/index.ts"],"names":[],"mappings":""}

package/dist/client/models/pipe_output.d.ts

@@ -0,0 +1,2 @@
+export type { DictPipeOutput } from "../../runners/types.js";
+export type VariableMultiplicity = boolean | number;

package/dist/client/models/pipe_output.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipe_output.js.map

package/dist/client/models/pipe_output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe_output.js","sourceRoot":"","sources":["../../../src/client/models/pipe_output.ts"],"names":[],"mappings":""}

package/dist/client/models/pipeline_inputs.d.ts

@@ -0,0 +1,3 @@
+import type { DictStuff } from "./stuff.js";
+export type StuffContentOrData = string | string[] | Record<string, unknown> | DictStuff;
+export type PipelineInputs = Record<string, StuffContentOrData>;

package/dist/client/models/pipeline_inputs.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipeline_inputs.js.map

package/dist/client/models/pipeline_inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline_inputs.js","sourceRoot":"","sources":["../../../src/client/models/pipeline_inputs.ts"],"names":[],"mappings":""}

package/dist/client/models/stuff.d.ts

@@ -0,0 +1 @@
+export type { DictStuff } from "../../runners/types.js";

package/dist/client/models/stuff.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stuff.js.map

package/dist/client/models/stuff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuff.js","sourceRoot":"","sources":["../../../src/client/models/stuff.ts"],"names":[],"mappings":""}

package/dist/client/models/working_memory.d.ts

@@ -0,0 +1 @@
+export type { DictWorkingMemory } from "../../runners/types.js";

package/dist/client/models/working_memory.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=working_memory.js.map

package/dist/client/models/working_memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"working_memory.js","sourceRoot":"","sources":["../../../src/client/models/working_memory.ts"],"names":[],"mappings":""}

package/dist/client/pipeline.d.ts

@@ -0,0 +1,36 @@
+import type { DictPipeOutput } from "./models/pipe_output.js";
+import type { VariableMultiplicity } from "./models/pipe_output.js";
+import type { PipelineInputs } from "./models/pipeline_inputs.js";
+export type { PipelineState } from "../runners/types.js";
+export interface PipelineRequest {
+    pipe_code?: string | null;
+    mthds_content?: string | null;
+    inputs?: PipelineInputs | null;
+    output_name?: string | null;
+    output_multiplicity?: VariableMultiplicity | null;
+    dynamic_output_concept_code?: string | null;
+}
+export interface PipelineExecuteResponse {
+    pipeline_run_id: string;
+    created_at: string;
+    pipeline_state: string;
+    finished_at?: string | null;
+    main_stuff_name?: string | null;
+    pipe_output: DictPipeOutput;
+}
+export interface PipelineStartResponse {
+    pipeline_run_id: string;
+    created_at: string;
+    pipeline_state: string;
+    finished_at?: string | null;
+    main_stuff_name?: string | null;
+    pipe_output?: DictPipeOutput | null;
+}
+export interface ExecutePipelineOptions {
+    pipe_code?: string | null;
+    mthds_content?: string | null;
+    inputs?: PipelineInputs | null;
+    output_name?: string | null;
+    output_multiplicity?: VariableMultiplicity | null;
+    dynamic_output_concept_code?: string | null;
+}

package/dist/client/pipeline.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipeline.js.map

package/dist/client/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/client/pipeline.ts"],"names":[],"mappings":""}

package/dist/client/protocol.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutePipelineOptions, PipelineExecuteResponse, PipelineStartResponse } from "./pipeline.js";
+export interface RunnerProtocol {
+    executePipeline(options: ExecutePipelineOptions): Promise<PipelineExecuteResponse>;
+    startPipeline(options: ExecutePipelineOptions): Promise<PipelineStartResponse>;
+}

package/dist/client/protocol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/client/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/client/protocol.ts"],"names":[],"mappings":""}

package/dist/commands/build.d.ts

@@ -0,0 +1,19 @@
+import type { RunnerType } from "../runners/types.js";
+interface WithRunner {
+    runner?: RunnerType;
+}
+export declare function buildPipe(brief: string, options: {
+    output?: string;
+} & WithRunner): Promise<void>;
+export declare function buildRunner(target: string, options: {
+    pipe?: string;
+    output?: string;
+} & WithRunner): Promise<void>;
+export declare function buildInputs(target: string, options: {
+    pipe: string;
+} & WithRunner): Promise<void>;
+export declare function buildOutput(target: string, options: {
+    pipe: string;
+    format?: string;
+} & WithRunner): Promise<void>;
+export {};