mthds 0.0.3 → 0.0.5

package/README.md

@@ -1,12 +1,16 @@
 # mthds
 
-CLI for installing and managing **methods** — reusable workflows for AI coding agents.
+CLI and SDK for **methods** — reusable workflows for AI coding agents.
+
+The MTHDS open standard is defined at [mthds.ai](https://mthds.ai). Browse and discover public methods on the hub at [mthds.sh](https://mthds.sh).
 
 ## 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>
@@ -17,7 +21,7 @@ The CLI will:
 1. Look up the method in the registry
 2. Ask which AI agent to install it for (Claude Code, with more coming soon)
 3. Ask where to install — **local** (current project) or **global** (your machine)
-4. Optionally install the pipelex software runtime
+4. Optionally install a [runner](#runners)
 5. Write the method to `.claude/methods/<slug>/METHOD.mthds`
 
 ### Install locations
@@ -27,13 +31,101 @@ The CLI will:
 | Local | `<cwd>/.claude/methods/<slug>/` |
 | Global | `~/.claude/methods/<slug>/` |
 
-## Install software runtime
+## Runners
+
+To execute a method, you need a **runner**. A runner is the engine that takes a method definition and actually runs it.
+
+### Available runners
+
+| Runner | Description |
+|--------|-------------|
+| **Pipelex** (local) | A Python-based runner you install on your machine. Install it with `npx mthds setup runner pipelex`. |
+| **Pipelex API** (remote) | An API server that runs methods remotely. You can self-host it using [pipelex-api](https://github.com/Pipelex/pipelex-api) (open source). A public hosted API at `https://api.pipelex.com` is coming soon. |
+
+These are the only runners that exist today. Feel free to create your own runner in a different language!
+
+### Install the local runner
 
 ```bash
-npx mthds setup software pipelex
+npx mthds setup runner pipelex
 ```
 
-Installs [uv](https://docs.astral.sh/uv/) and [pipelex](https://pipelex.dev) so methods that depend on them can run.
+### Use the API runner
+
+See the [SDK Usage](#sdk-usage) section below to connect to a Pipelex API instance.
+
+## 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);
+```
+
+### Self-hosted API
+
+Point the client to your own [pipelex-api](https://github.com/Pipelex/pipelex-api) instance:
+
+```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
 

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/index.js

@@ -52,7 +52,7 @@ export function showBanner() {
     console.log(`    ${chalk.dim("$")} mthds build pipe "Analyze a CV against a job offer"`);
     console.log(`    ${chalk.dim("$")} mthds validate my_bundle.plx`);
     console.log(`    ${chalk.dim("$")} mthds install my-method-slug\n`);
-    console.log(chalk.dim("  Docs: https://pipelex.dev/docs\n"));
+    console.log(chalk.dim("  Docs: https://docs.pipelex.com \n"));
     console.log(chalk.bold("  Telemetry:"));
     console.log(chalk.dim("  Anonymous usage data (method slug + timestamp) is collected\n  to help rank methods. No personal info is collected.\n  Opt out: DISABLE_TELEMETRY=1\n"));
 }

package/dist/commands/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from "./client/index.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./client/index.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,cAAc,mBAAmB,CAAC"}

package/dist/runtime/check.d.ts

@@ -1,2 +1 @@
-export declare function isUvInstalled(): boolean;
 export declare function isPipelexInstalled(): boolean;

package/dist/runtime/check.js

@@ -1,20 +1,8 @@
 import { execFileSync } from "node:child_process";
-export function isUvInstalled() {
-    try {
-        execFileSync("uv", ["--version"], { stdio: "ignore" });
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
 export function isPipelexInstalled() {
     try {
-        const output = execFileSync("uv", ["tool", "list"], {
-            encoding: "utf-8",
-            stdio: ["ignore", "pipe", "ignore"],
-        });
-        return output.includes("pipelex");
+        execFileSync("pipelex", ["--version"], { stdio: "ignore" });
+        return true;
     }
     catch {
         return false;

package/dist/runtime/check.js.map

@@ -1 +1 @@
-{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/runtime/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,YAAY,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;YAClD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/runtime/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,YAAY,CAAC,SAAS,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/runtime/installer.js

@@ -1,39 +1,28 @@
-import { execSync, execFileSync } from "node:child_process";
+import { execSync } from "node:child_process";
 import ora from "ora";
-import { isUvInstalled, isPipelexInstalled } from "./check.js";
+import { isPipelexInstalled } from "./check.js";
 export async function ensureRuntime() {
-    if (!isUvInstalled()) {
-        await installUv();
-    }
     if (!isPipelexInstalled()) {
         await installPipelex();
     }
 }
-async function installUv() {
-    const spinner = ora("Installing uv runtime...").start();
-    try {
-        execSync("curl -LsSf https://astral.sh/uv/install.sh | sh", {
-            stdio: "ignore",
-            shell: "/bin/sh",
-        });
-        spinner.succeed("uv installed");
-    }
-    catch (error) {
-        spinner.fail("Failed to install uv");
-        throw new Error("Could not install uv. Please install it manually: https://docs.astral.sh/uv/getting-started/installation/");
-    }
-}
 async function installPipelex() {
-    const spinner = ora("Setting up pipelex runtime...").start();
+    const spinner = ora("Installing pipelex...").start();
     try {
-        execFileSync("uv", ["tool", "install", "pipelex"], {
-            stdio: "ignore",
-        });
+        if (process.platform === "win32") {
+            execSync('powershell -Command "irm https://pipelex.com/install.ps1 | iex"', { stdio: "ignore" });
+        }
+        else {
+            execSync("curl -fsSL https://pipelex.com/install.sh | sh", {
+                stdio: "ignore",
+                shell: "/bin/sh",
+            });
+        }
         spinner.succeed("pipelex installed");
     }
     catch (error) {
         spinner.fail("Failed to install pipelex");
-        throw new Error("Could not install pipelex via uv. Try manually: uv tool install pipelex");
+        throw new Error("Could not install pipelex. Please install it manually: https://pipelex.com");
     }
 }
 //# sourceMappingURL=installer.js.map

package/dist/runtime/installer.js.map

@@ -1 +1 @@
-{"version":3,"file":"installer.js","sourceRoot":"","sources":["../../src/runtime/installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACrB,MAAM,SAAS,EAAE,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC1B,MAAM,cAAc,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,MAAM,OAAO,GAAG,GAAG,CAAC,0BAA0B,CAAC,CAAC,KAAK,EAAE,CAAC;IACxD,IAAI,CAAC;QACH,QAAQ,CAAC,iDAAiD,EAAE;YAC1D,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,2GAA2G,CAC5G,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc;IAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,+BAA+B,CAAC,CAAC,KAAK,EAAE,CAAC;IAC7D,IAAI,CAAC;QACH,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE;YACjD,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../../src/runtime/installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC1B,MAAM,cAAc,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc;IAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,uBAAuB,CAAC,CAAC,KAAK,EAAE,CAAC;IACrD,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,QAAQ,CACN,iEAAiE,EACjE,EAAE,KAAK,EAAE,QAAQ,EAAE,CACpB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,gDAAgD,EAAE;gBACzD,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,18 +1,27 @@
 {
   "name": "mthds",
-  "version": "0.0.3",
-  "description": "CLI for composable methods for AI agents. Turn your knowledge processes into executable methods.",
+  "version": "0.0.5",
+  "description": "CLI and SDK for MTHDS — the open standard for reusable AI agent methods. Install, execute, and manage methods.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Pipelex/mthds-js"
+    "url": "https://github.com/mthds-ai/mthds-js"
   },
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
   "bin": {
     "mthds": "./dist/cli.js"
   },
   "scripts": {
-    "build": "tsc"
+    "build": "tsc",
+    "example": "npx tsx examples/call_api.ts"
   },
   "files": [
     "dist/"
@@ -30,6 +39,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.12.0",
+    "tsx": "^4.19.0",
     "typescript": "^5.7.3"
   }
 }