mthds 0.9.0 → 0.11.0

package/dist/runners/types.d.ts

@@ -1,11 +1,13 @@
-import type { RunnerProtocol } from "../client/protocol.js";
+import type { MTHDSProtocol } from "../protocol/protocol.js";
+import type { StartOptions } from "../protocol/options.js";
+import type { RunRead, RunResultState, RunResults, WaitForResultOptions } from "./api/runs.js";
+import type { DictPipeOutput } from "./api/models.js";
 export declare const Runners: {
     readonly API: "api";
     readonly PIPELEX: "pipelex";
 };
 export type RunnerType = (typeof Runners)[keyof typeof Runners];
 export declare const RUNNER_NAMES: RunnerType[];
-export type PipelineState = "RUNNING" | "COMPLETED" | "FAILED" | "CANCELLED" | "ERROR" | "STARTED";
 export type ConceptRepresentationFormat = "json" | "python" | "schema";
 export interface BuildInputsRequest {
     mthds_contents: string[];
@@ -20,20 +22,6 @@ export interface BuildRunnerRequest {
     mthds_contents: string[];
     pipe_code: string;
 }
-export interface ExecuteRequest {
-    /** MTHDS bundle content(s) to validate, load, and execute. Omit to run an already-loaded pipe. */
-    mthds_contents?: string[];
-    pipe_code?: string;
-    inputs?: Record<string, unknown>;
-}
-export interface ValidateRequest {
-    /** GitHub URL or local path to the method directory (preferred). */
-    method_url?: string;
-    /** Pipe code to validate (optional — validates a specific pipe). */
-    pipe_code?: string;
-    /** Raw .mthds file content(s). */
-    mthds_contents?: string[];
-}
 export interface ConceptRequest {
     spec: Record<string, unknown>;
 }
@@ -41,6 +29,7 @@ export interface PipeSpecRequest {
     pipe_type: string;
     spec: Record<string, unknown>;
 }
+/** Request for `PipelexRunner.checkModel` — a LOCAL CLI capability only (no API route). */
 export interface CheckModelRequest {
     reference: string;
     type: string;
@@ -52,42 +41,6 @@ export interface BuildRunnerResponse {
     success: boolean;
     message: string;
 }
-export interface DictStuff {
-    concept: string;
-    content: unknown;
-}
-export interface DictWorkingMemory {
-    root: Record<string, DictStuff>;
-    aliases: Record<string, string>;
-}
-export interface DictPipeOutput {
-    working_memory: DictWorkingMemory;
-    graph_spec?: unknown;
-    pipeline_run_id: string;
-}
-export interface PipelineResponse {
-    pipeline_run_id: string;
-    created_at: string;
-    pipeline_state: PipelineState;
-    finished_at?: string | null;
-    pipe_output?: DictPipeOutput | null;
-    main_stuff_name?: string | null;
-}
-export interface PipelexBundleBlueprint {
-    source?: string | null;
-    domain: string;
-    description?: string | null;
-    system_prompt?: string | null;
-    main_pipe?: string | null;
-    concept?: Record<string, unknown> | null;
-    pipe?: Record<string, unknown> | null;
-}
-export interface ValidateResponse {
-    mthds_contents: string[];
-    pipelex_bundle_blueprint: PipelexBundleBlueprint;
-    success: boolean;
-    message: string;
-}
 export interface ConceptResponse {
     success: boolean;
     concept_code: string;
@@ -99,6 +52,7 @@ export interface PipeSpecResponse {
     pipe_type: string;
     toml: string;
 }
+/** Response of `PipelexRunner.checkModel` — a LOCAL CLI capability only (no API route). */
 export interface CheckModelResponse {
     success: boolean;
     valid: boolean;
@@ -106,30 +60,18 @@ export interface CheckModelResponse {
     suggestions?: string[];
     [key: string]: unknown;
 }
-export interface ModelsRequest {
-    type?: string[];
-}
-export interface ModelsResponse {
-    success: boolean;
-    presets: Record<string, Array<{
-        name: string;
-        description?: string;
-    }>>;
-    aliases: Record<string, Record<string, string>>;
-    waterfalls: Record<string, Record<string, string[]>>;
-    talent_mappings: Record<string, Record<string, string>>;
-}
-export interface Runner extends RunnerProtocol {
+export interface Runner extends MTHDSProtocol<DictPipeOutput> {
     readonly type: RunnerType;
     health(): Promise<Record<string, unknown>>;
-    version(): Promise<Record<string, string>>;
     buildInputs(request: BuildInputsRequest): Promise<unknown>;
     buildOutput(request: BuildOutputRequest): Promise<unknown>;
     buildRunner(request: BuildRunnerRequest): Promise<BuildRunnerResponse>;
-    execute(request: ExecuteRequest): Promise<PipelineResponse>;
-    validate(request: ValidateRequest): Promise<ValidateResponse>;
     concept(request: ConceptRequest): Promise<ConceptResponse>;
     pipeSpec(request: PipeSpecRequest): Promise<PipeSpecResponse>;
-    models(request?: ModelsRequest): Promise<ModelsResponse>;
-    checkModel(request: CheckModelRequest): Promise<CheckModelResponse>;
+    getRunStatus(runId: string): Promise<RunRead>;
+    getRunResult(runId: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<RunResultState>;
+    waitForResult(runId: string, options?: WaitForResultOptions): Promise<RunResults>;
+    startAndWaitForResult(options: StartOptions, pollOptions?: WaitForResultOptions): Promise<RunResults>;
 }

package/dist/runners/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runners/types.ts"],"names":[],"mappings":"AAEA,uEAAuE;AAEvE,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;CACV,CAAC;AAIX,MAAM,CAAC,MAAM,YAAY,GAAiB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runners/types.ts"],"names":[],"mappings":"AAUA,uEAAuE;AAEvE,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;CACV,CAAC;AAIX,MAAM,CAAC,MAAM,YAAY,GAAiB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mthds",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "CLI and SDK for MTHDS — the open standard for executable AI methods. Install, execute, and manage methods.",
   "license": "MIT",
   "repository": {
@@ -23,7 +23,9 @@
   "scripts": {
     "build": "tsc",
     "test": "vitest run",
-    "example": "npx tsx examples/call_api.ts"
+    "depcruise": "depcruise --config .dependency-cruiser.cjs src",
+    "example": "npx tsx examples/call_api.ts",
+    "prepare": "tsc"
   },
   "files": [
     "dist/"
@@ -44,8 +46,9 @@
   "devDependencies": {
     "@types/node": "^22.12.0",
     "@types/semver": "^7.7.1",
+    "dependency-cruiser": "^17.4.3",
     "tsx": "^4.19.0",
     "typescript": "^5.7.3",
     "vitest": "^4.0.18"
   }
-}
+}

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

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

package/dist/agent/commands/validate.js

@@ -1,126 +0,0 @@
-/**
- * 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;
-}
-async function agentValidateTarget(options, fallbackMsg) {
-    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(fallbackMsg, "ArgumentError", {
-        error_domain: AGENT_ERROR_DOMAINS.ARGUMENT,
-    });
-}
-export async function agentValidateMethod(_target, options) {
-    return agentValidateTarget(options, "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>.");
-}
-export async function agentValidateBundle(_target, options) {
-    return agentValidateTarget(options, "Bundle target is only supported with the pipelex runner. Specify --runner pipelex.");
-}
-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_contents: [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

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

package/dist/client/client.d.ts

@@ -1,15 +0,0 @@
-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

@@ -1,127 +0,0 @@
-import { ApiResponseError, ApiUnreachableError, ClientAuthenticationError, PipelineRequestError, } from "./exceptions.js";
-export class MthdsApiClient {
-    apiToken;
-    apiBaseUrl;
-    constructor(options = {}) {
-        this.apiToken = options.apiToken ?? process.env.PIPELEX_API_KEY;
-        const resolvedBaseUrl = options.apiBaseUrl ?? process.env.PIPELEX_API_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}`;
-        }
-        let response;
-        try {
-            response = await fetch(url, {
-                method: "POST",
-                headers,
-                body: JSON.stringify(pipelineRequest),
-                signal: AbortSignal.timeout(1_200_000),
-            });
-        }
-        catch (err) {
-            // undici (Node fetch) wraps DNS/connect/TLS failures as
-            // `TypeError("fetch failed")` with the system error attached as `cause`.
-            // `AbortSignal.timeout` rejects with a DOMException named "TimeoutError".
-            const code = extractNetworkErrorCode(err);
-            throw new ApiUnreachableError(`Could not reach Pipelex API at ${this.apiBaseUrl} (${code ?? "network error"})`, this.apiBaseUrl, code, { cause: err });
-        }
-        if (!response.ok) {
-            const body = await response.text().catch(() => "");
-            const { errorType, serverMessage } = parseErrorBody(body);
-            throw new ApiResponseError(`API POST /${endpoint} failed (${response.status}): ${serverMessage ?? (body || response.statusText)}`, this.apiBaseUrl, response.status, response.statusText, body, errorType, serverMessage);
-        }
-        return response.json();
-    }
-    async executePipeline(options) {
-        if (!options.pipe_code && (!options.mthds_contents || options.mthds_contents.length === 0)) {
-            throw new PipelineRequestError("Either pipe_code or mthds_contents must be provided to executePipeline.");
-        }
-        const request = {
-            pipe_code: options.pipe_code,
-            mthds_contents: options.mthds_contents,
-            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_contents || options.mthds_contents.length === 0)) {
-            throw new PipelineRequestError("Either pipe_code or mthds_contents must be provided to startPipeline.");
-        }
-        const request = {
-            pipe_code: options.pipe_code,
-            mthds_contents: options.mthds_contents,
-            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;
-    }
-}
-function extractNetworkErrorCode(err) {
-    if (err instanceof DOMException && err.name === "TimeoutError") {
-        return "ABORT_TIMEOUT";
-    }
-    if (err instanceof Error) {
-        const cause = err.cause;
-        if (cause && typeof cause === "object" && "code" in cause) {
-            const code = cause.code;
-            if (typeof code === "string")
-                return code;
-        }
-    }
-    return undefined;
-}
-/**
- * Pipelex API serializes errors as `{"detail": {"error_type": ..., "message": ...}}`
- * (HTTPException with dict detail) or `{"detail": "..."}` (auth 401s).
- * Both shapes are extracted here. Falls through silently on non-JSON bodies.
- */
-function parseErrorBody(body) {
-    if (!body)
-        return { errorType: undefined, serverMessage: undefined };
-    let parsed;
-    try {
-        parsed = JSON.parse(body);
-    }
-    catch {
-        return { errorType: undefined, serverMessage: undefined };
-    }
-    if (!parsed || typeof parsed !== "object") {
-        return { errorType: undefined, serverMessage: undefined };
-    }
-    const root = parsed;
-    const detail = root.detail;
-    let errorType;
-    let serverMessage;
-    if (detail && typeof detail === "object") {
-        const d = detail;
-        if (typeof d.error_type === "string")
-            errorType = d.error_type;
-        if (typeof d.message === "string")
-            serverMessage = d.message;
-    }
-    else if (typeof detail === "string") {
-        serverMessage = detail;
-    }
-    if (errorType === undefined && typeof root.error_type === "string")
-        errorType = root.error_type;
-    if (serverMessage === undefined && typeof root.message === "string")
-        serverMessage = root.message;
-    return { errorType, serverMessage };
-}
-//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAOzB,MAAM,OAAO,cAAc;IACR,QAAQ,CAAqB;IAC7B,UAAU,CAAS;IAEpC,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QAEhE,MAAM,eAAe,GACnB,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;QACpD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,yBAAyB,CACjC,4CAA4C,CAC7C,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,QAAgB,EAChB,eAAgC;QAEhC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,QAAQ,EAAE,CAAC;QAE7C,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QACF,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvD,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC1B,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC;gBACrC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;aACvC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,wDAAwD;YACxD,yEAAyE;YACzE,0EAA0E;YAC1E,MAAM,IAAI,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;YAC1C,MAAM,IAAI,mBAAmB,CAC3B,kCAAkC,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,eAAe,GAAG,EAChF,IAAI,CAAC,UAAU,EACf,IAAI,EACJ,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YAC1D,MAAM,IAAI,gBAAgB,CACxB,aAAa,QAAQ,YAAY,QAAQ,CAAC,MAAM,MAAM,aAAa,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,EAAE,EACtG,IAAI,CAAC,UAAU,EACf,QAAQ,CAAC,MAAM,EACf,QAAQ,CAAC,UAAU,EACnB,IAAI,EACJ,SAAS,EACT,aAAa,CACd,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,OAA+B;QAE/B,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YAC3F,MAAM,IAAI,oBAAoB,CAC5B,yEAAyE,CAC1E,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAoB;YAC/B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;YAChD,2BAA2B,EAAE,OAAO,CAAC,2BAA2B;SACjE,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC;QACxE,OAAO,IAA+B,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,OAA+B;QAE/B,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YAC3F,MAAM,IAAI,oBAAoB,CAC5B,uEAAuE,CACxE,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAoB;YAC/B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;YAChD,2BAA2B,EAAE,OAAO,CAAC,2BAA2B;SACjE,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;QACtE,OAAO,IAA6B,CAAC;IACvC,CAAC;CACF;AAED,SAAS,uBAAuB,CAAC,GAAY;IAC3C,IAAI,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QAC/D,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAI,GAAmC,CAAC,KAAK,CAAC;QACzD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YAC1D,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;YAChD,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;IACrE,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;IAC5D,CAAC;IACD,MAAM,IAAI,GAAG,MAAiC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,SAA6B,CAAC;IAClC,IAAI,aAAiC,CAAC;IACtC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,MAAiC,CAAC;QAC5C,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;YAAE,SAAS,GAAG,CAAC,CAAC,UAAU,CAAC;QAC/D,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;YAAE,aAAa,GAAG,CAAC,CAAC,OAAO,CAAC;IAC/D,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtC,aAAa,GAAG,MAAM,CAAC;IACzB,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;QAAE,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;IAChG,IAAI,aAAa,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAAE,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC;IAClG,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AACtC,CAAC"}

package/dist/client/exceptions.d.ts

@@ -1,46 +0,0 @@
-export declare class ClientAuthenticationError extends Error {
-    constructor(message: string);
-}
-export declare class PipelineRequestError extends Error {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * Thrown when the Pipelex API host cannot be reached at all (DNS failure,
- * connection refused, TLS handshake failure, request timeout). The HTTP
- * exchange never produced a response — distinguish from `ApiResponseError`,
- * which represents a non-2xx response that did come back.
- *
- * `code` is the underlying network error code when available
- * (`ECONNREFUSED`, `ENOTFOUND`, `ETIMEDOUT`, `EAI_AGAIN`, `ABORT_TIMEOUT`).
- */
-export declare class ApiUnreachableError extends PipelineRequestError {
-    readonly apiUrl: string;
-    readonly code: string | undefined;
-    constructor(message: string, apiUrl: string, code: string | undefined, options?: {
-        cause?: unknown;
-    });
-}
-/**
- * Thrown when the API returned a non-2xx HTTP response. Carries structured
- * fields so callers can render meaningful UI without parsing the message:
- * - `status` / `statusText` — HTTP status from the response
- * - `responseBody` — raw response body (always retained)
- * - `errorType` / `serverMessage` — parsed from the JSON body when present
- *
- * Pipelex API serializes errors as `{"detail": {"error_type", "message"}}`
- * (HTTPException with dict detail) or `{"detail": "..."}` (auth 401s).
- * Both shapes are extracted here.
- */
-export declare class ApiResponseError extends PipelineRequestError {
-    readonly apiUrl: string;
-    readonly status: number;
-    readonly statusText: string;
-    readonly responseBody: string;
-    readonly errorType: string | undefined;
-    readonly serverMessage: string | undefined;
-    constructor(message: string, apiUrl: string, status: number, statusText: string, responseBody: string, errorType: string | undefined, serverMessage: string | undefined, options?: {
-        cause?: unknown;
-    });
-}

package/dist/client/exceptions.js

@@ -1,61 +0,0 @@
-export class ClientAuthenticationError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "ClientAuthenticationError";
-    }
-}
-export class PipelineRequestError extends Error {
-    constructor(message, options) {
-        super(message, options);
-        this.name = "PipelineRequestError";
-    }
-}
-/**
- * Thrown when the Pipelex API host cannot be reached at all (DNS failure,
- * connection refused, TLS handshake failure, request timeout). The HTTP
- * exchange never produced a response — distinguish from `ApiResponseError`,
- * which represents a non-2xx response that did come back.
- *
- * `code` is the underlying network error code when available
- * (`ECONNREFUSED`, `ENOTFOUND`, `ETIMEDOUT`, `EAI_AGAIN`, `ABORT_TIMEOUT`).
- */
-export class ApiUnreachableError extends PipelineRequestError {
-    apiUrl;
-    code;
-    constructor(message, apiUrl, code, options) {
-        super(message, options);
-        this.name = "ApiUnreachableError";
-        this.apiUrl = apiUrl;
-        this.code = code;
-    }
-}
-/**
- * Thrown when the API returned a non-2xx HTTP response. Carries structured
- * fields so callers can render meaningful UI without parsing the message:
- * - `status` / `statusText` — HTTP status from the response
- * - `responseBody` — raw response body (always retained)
- * - `errorType` / `serverMessage` — parsed from the JSON body when present
- *
- * Pipelex API serializes errors as `{"detail": {"error_type", "message"}}`
- * (HTTPException with dict detail) or `{"detail": "..."}` (auth 401s).
- * Both shapes are extracted here.
- */
-export class ApiResponseError extends PipelineRequestError {
-    apiUrl;
-    status;
-    statusText;
-    responseBody;
-    errorType;
-    serverMessage;
-    constructor(message, apiUrl, status, statusText, responseBody, errorType, serverMessage, options) {
-        super(message, options);
-        this.name = "ApiResponseError";
-        this.apiUrl = apiUrl;
-        this.status = status;
-        this.statusText = statusText;
-        this.responseBody = responseBody;
-        this.errorType = errorType;
-        this.serverMessage = serverMessage;
-    }
-}
-//# sourceMappingURL=exceptions.js.map

package/dist/client/exceptions.js.map

@@ -1 +0,0 @@
-{"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,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAmC,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAoB,SAAQ,oBAAoB;IAC3C,MAAM,CAAS;IACf,IAAI,CAAqB;IAEzC,YACE,OAAe,EACf,MAAc,EACd,IAAwB,EACxB,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAiB,SAAQ,oBAAoB;IACxC,MAAM,CAAS;IACf,MAAM,CAAS;IACf,UAAU,CAAS;IACnB,YAAY,CAAS;IACrB,SAAS,CAAqB;IAC9B,aAAa,CAAqB;IAElD,YACE,OAAe,EACf,MAAc,EACd,MAAc,EACd,UAAkB,EAClB,YAAoB,EACpB,SAA6B,EAC7B,aAAiC,EACjC,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF"}

package/dist/client/index.d.ts

@@ -1,5 +0,0 @@
-export { MthdsApiClient } from "./client.js";
-export type { RunnerProtocol } from "./protocol.js";
-export { ApiResponseError, ApiUnreachableError, 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

@@ -1,3 +0,0 @@
-export { MthdsApiClient } from "./client.js";
-export { ApiResponseError, ApiUnreachableError, ClientAuthenticationError, PipelineRequestError, } from "./exceptions.js";
-//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

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

@@ -1,4 +0,0 @@
-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

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

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

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

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

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

package/dist/client/models/pipe_output.js

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

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

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

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

@@ -1,3 +0,0 @@
-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

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

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

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

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

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

package/dist/client/models/stuff.js

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

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

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