mthds 0.9.0 → 0.11.0

package/dist/config/config.js

@@ -8,8 +8,8 @@ const CONFIG_PATH = join(CONFIG_DIR, "config");
 // ── Config keys ───────────────────────────────────────────────────
 /** Map from config key to env var name */
 const ENV_NAMES = {
-    apiUrl: "PIPELEX_API_URL",
-    apiKey: "PIPELEX_API_KEY",
+    baseUrl: "MTHDS_API_URL",
+    apiKey: "MTHDS_API_KEY",
     runner: "MTHDS_RUNNER",
     telemetry: "DISABLE_TELEMETRY",
     autoUpgrade: "MTHDS_AUTO_UPGRADE",
@@ -17,17 +17,19 @@ const ENV_NAMES = {
 };
 /** Map from config key to file key (used in ~/.mthds/config) */
 const FILE_KEYS = {
-    apiUrl: "PIPELEX_API_URL",
-    apiKey: "PIPELEX_API_KEY",
+    baseUrl: "MTHDS_API_URL",
+    apiKey: "MTHDS_API_KEY",
     runner: "MTHDS_RUNNER",
     telemetry: "DISABLE_TELEMETRY",
     autoUpgrade: "MTHDS_AUTO_UPGRADE",
     updateCheck: "MTHDS_UPDATE_CHECK",
 };
+/** Hosted default — host only; endpoints compose as `{base}/v1/{endpoint}`. */
+export const DEFAULT_BASE_URL = "https://api.pipelex.com";
 /** Defaults */
 const DEFAULTS = {
     runner: Runners.PIPELEX,
-    apiUrl: "https://api.pipelex.com",
+    baseUrl: DEFAULT_BASE_URL,
     apiKey: "",
     telemetry: true,
     autoUpgrade: false,
@@ -36,7 +38,7 @@ const DEFAULTS = {
 /** Map from CLI flag names (kebab-case) to config keys */
 const KEY_ALIASES = {
     runner: "runner",
-    "api-url": "apiUrl",
+    "base-url": "baseUrl",
     "api-key": "apiKey",
     telemetry: "telemetry",
     "auto-upgrade": "autoUpgrade",
@@ -56,6 +58,29 @@ const INVERTED_BOOLEAN_KEYS = new Set([
 /** Strings treated as truthy for boolean keys — used in both load and set paths */
 const TRUTHY_STRINGS = new Set(["true", "1", "yes", "on"]);
 export const VALID_KEYS = Object.keys(KEY_ALIASES);
+/**
+ * A base URL must be HOST ONLY — http/https, no path, query, or fragment.
+ * The client composes `{base}/v1/{endpoint}`; a path-prefixed value (e.g. a
+ * leftover `.../runner/v1`) would produce malformed `/v1/v1/...` endpoints.
+ */
+export function isValidBaseUrl(value) {
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        return false;
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:")
+        return false;
+    if (parsed.pathname !== "/" && parsed.pathname !== "")
+        return false;
+    // Host only also means no embedded credentials — auth travels in the
+    // Authorization header (MTHDS_API_KEY), never in the URL.
+    if (parsed.username || parsed.password)
+        return false;
+    return !parsed.search && !parsed.hash;
+}
 export function resolveKey(cliKey) {
     return KEY_ALIASES[cliKey];
 }

package/dist/config/config.js.map

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

package/dist/index.d.ts

@@ -1 +1,27 @@
-export * from "./client/index.js";
+/**
+ * Public SDK barrel — re-exports the MTHDS Protocol surface (`protocol/`) and
+ * the API runner + run-lifecycle extension (`runners/api/`).
+ *
+ * Structural split (protocol ⊥ runners) parity with `mthds-python`:
+ *   - `mthds/client/*` is gone. The protocol interface + wire models live in
+ *     `protocol/`; the API client/runner, lifecycle polling, and Dict-serialized
+ *     concretes live in `runners/api/`.
+ *   - The single run response `RunResult` is split into `RunResultExecute<T>`
+ *     (execute — has `pipe_output`) and `RunResultStart` (start — id only).
+ */
+export { MthdsApiClient, DEFAULT_API_BASE_URL } from "./runners/api/client.js";
+export type { MTHDSProtocol } from "./protocol/protocol.js";
+export { PipelineRequestError } from "./protocol/exceptions.js";
+export { ApiResponseError, ApiUnreachableError, ClientAuthenticationError, PipelineExecuteTimeoutError, RunFailedError, RunTimeoutError, RunStillRunningError, RunLifecycleUnavailableError, } from "./runners/api/exceptions.js";
+export type { RunRequest, StartRequest, RunOptions, StartOptions, ExtensionOptions, } from "./protocol/options.js";
+export { MTHDS_PROTOCOL_VERSION, MODEL_CATEGORIES } from "./protocol/models.js";
+export type { RunResultExecute, RunResultStart, ModelCategory, ModelInfo, ModelDeck, ValidationReport, ValidationError, InvalidValidationReport, ValidationResult, VersionInfo, } from "./protocol/models.js";
+export type { VariableMultiplicity, PipeOutputAbstract } from "./protocol/pipe_output.js";
+export type { StuffContentOrData, PipelineInputs } from "./protocol/pipeline_inputs.js";
+export { conceptRef } from "./protocol/concept.js";
+export type { ConceptAbstract } from "./protocol/concept.js";
+export type { StuffAbstract, StuffContentAbstract } from "./protocol/stuff.js";
+export type { WorkingMemoryAbstract } from "./protocol/working_memory.js";
+export { isTerminalRunStatus, isSuccessRunStatus } from "./runners/api/runs.js";
+export type { RunStatus, RunPublic, RunRead, RunResults, RunResultState, WaitForResultOptions, } from "./runners/api/runs.js";
+export type { DictStuff, DictWorkingMemory, DictPipeOutput, DictRunResultExecute, PipelexValidationReport, PipelexInvalidReport, PipelexValidationResult, ValidatedPipeEntry, DryRunStatus, ValidationErrorItem, ValidationErrorCategory, } from "./runners/api/models.js";

package/dist/index.js

@@ -1,2 +1,23 @@
-export * from "./client/index.js";
+/**
+ * Public SDK barrel — re-exports the MTHDS Protocol surface (`protocol/`) and
+ * the API runner + run-lifecycle extension (`runners/api/`).
+ *
+ * Structural split (protocol ⊥ runners) parity with `mthds-python`:
+ *   - `mthds/client/*` is gone. The protocol interface + wire models live in
+ *     `protocol/`; the API client/runner, lifecycle polling, and Dict-serialized
+ *     concretes live in `runners/api/`.
+ *   - The single run response `RunResult` is split into `RunResultExecute<T>`
+ *     (execute — has `pipe_output`) and `RunResultStart` (start — id only).
+ */
+// ── API runner / client (runners/api) ────────────────────────────────
+export { MthdsApiClient, DEFAULT_API_BASE_URL } from "./runners/api/client.js";
+// ── Exceptions (protocol base + api-runner errors) ───────────────────
+export { PipelineRequestError } from "./protocol/exceptions.js";
+export { ApiResponseError, ApiUnreachableError, ClientAuthenticationError, PipelineExecuteTimeoutError, RunFailedError, RunTimeoutError, RunStillRunningError, RunLifecycleUnavailableError, } from "./runners/api/exceptions.js";
+// ── Wire models (protocol) ───────────────────────────────────────────
+export { MTHDS_PROTOCOL_VERSION, MODEL_CATEGORIES } from "./protocol/models.js";
+// ── Abstract domain shapes (protocol — exact mirror of mthds-python) ──
+export { conceptRef } from "./protocol/concept.js";
+// ── Run lifecycle (runners/api — hosted extension, NOT protocol) ──────
+export { isTerminalRunStatus, isSuccessRunStatus } from "./runners/api/runs.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wEAAwE;AACxE,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAK/E,wEAAwE;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC;AAWrC,wEAAwE;AACxE,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAgBhF,yEAAyE;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKnD,yEAAyE;AACzE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/protocol/concept.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Concept domain shape — exact mirror of `mthds/protocol/concept.py`
+ * (`ConceptAbstract`). The protocol-level abstract concept; runners deal in the
+ * Dict-serialized `concept` ref string (`runners/api/models.ts`).
+ */
+export interface ConceptAbstract {
+    code: string;
+    domain_code: string;
+    description: string;
+    structure_class_name: string;
+    refines?: string | null;
+}
+/** `{domain_code}.{code}` — python's `ConceptAbstract.concept_ref` derived property. */
+export declare function conceptRef(concept: Pick<ConceptAbstract, "domain_code" | "code">): string;

package/dist/protocol/concept.js

@@ -0,0 +1,10 @@
+/**
+ * Concept domain shape — exact mirror of `mthds/protocol/concept.py`
+ * (`ConceptAbstract`). The protocol-level abstract concept; runners deal in the
+ * Dict-serialized `concept` ref string (`runners/api/models.ts`).
+ */
+/** `{domain_code}.{code}` — python's `ConceptAbstract.concept_ref` derived property. */
+export function conceptRef(concept) {
+    return `${concept.domain_code}.${concept.code}`;
+}
+//# sourceMappingURL=concept.js.map

package/dist/protocol/concept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept.js","sourceRoot":"","sources":["../../src/protocol/concept.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,OAAsD;IAC/E,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/dist/protocol/exceptions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Protocol-level exceptions — the base error every MTHDS runner error derives
+ * from. Mirrors `mthds/protocol/exceptions.py`. Runner-specific errors (API
+ * transport, run lifecycle) live in `runners/api/exceptions.ts`.
+ */
+export declare class PipelineRequestError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}

package/dist/protocol/exceptions.js

@@ -0,0 +1,12 @@
+/**
+ * Protocol-level exceptions — the base error every MTHDS runner error derives
+ * from. Mirrors `mthds/protocol/exceptions.py`. Runner-specific errors (API
+ * transport, run lifecycle) live in `runners/api/exceptions.ts`.
+ */
+export class PipelineRequestError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "PipelineRequestError";
+    }
+}
+//# sourceMappingURL=exceptions.js.map

package/dist/protocol/exceptions.js.map

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

package/dist/protocol/models.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Wire models for the MTHDS Protocol — exact mirror of `mthds/protocol/models.py`
+ * (which mirrors `mthds-protocol.openapi.yaml`, the standard's normative artifact).
+ *
+ *   POST /execute  : -> RunResultExecute (200: pipeline_run_id + pipe_output)
+ *   POST /start    : -> RunResultStart   (202: pipeline_run_id only)
+ *   POST /validate :              -> ValidationResult (200: discriminated on `is_valid`)
+ *   GET  /models   :              -> ModelDeck
+ *   GET  /version  :              -> VersionInfo
+ *
+ * Response models declare the protocol's BASE fields only and are
+ * extension-open: an implementation may return more, and those server-specific
+ * fields are preserved (via the index signature) — the response side of the
+ * same passthrough principle as the request-side `extra`.
+ */
+/** The MTHDS Protocol version this SDK implements (the MTHDS standard version). */
+export declare const MTHDS_PROTOCOL_VERSION = "0.6.0";
+/**
+ * `POST /execute` 200 — the completed run.
+ *
+ * Two base fields: the authoritative server-generated `pipeline_run_id` and
+ * the method's `pipe_output` (always present — a completed run has output).
+ * Generic in the output type so `protocol/` never names a runner-side concrete:
+ * the default `DictPipeOutput` binding (`DictRunResultExecute`) lives in
+ * `runners/api/models.ts`. Extension-open: anything more an implementation
+ * returns (a run state, timestamps, output naming) rides the index signature,
+ * never named by this SDK.
+ */
+export interface RunResultExecute<TPipeOutput = unknown> {
+    pipeline_run_id: string;
+    pipe_output: TPipeOutput;
+    /** Implementation extension fields — defined and documented by the server. */
+    [extension: string]: unknown;
+}
+/**
+ * `POST /start` 202 (and the optional `/execute` 202 degrade) — the started
+ * run's authoritative `pipeline_run_id`, nothing else.
+ *
+ * A started run has no output yet; how it is delivered later (polling,
+ * callbacks, anything else) is implementation-defined and outside the
+ * protocol. Extension-open: an implementation may add its own fields (a
+ * workflow id, a created-at timestamp), preserved via the index signature.
+ */
+export interface RunResultStart {
+    pipeline_run_id: string;
+    /** Implementation extension fields — defined and documented by the server. */
+    [extension: string]: unknown;
+}
+/** Model categories accepted by the protocol's `GET /models?type=` filter. */
+export type ModelCategory = "llm" | "extract" | "img_gen" | "search";
+export declare const MODEL_CATEGORIES: readonly ModelCategory[];
+/** One entry of the model deck (`ModelDeck.models[]`) — base fields + extensions. */
+export interface ModelInfo {
+    name: string;
+    type?: ModelCategory | null;
+}
+/**
+ * The model deck a runner can route to — `GET /models`.
+ *
+ * The protocol's base is the `models` list; implementations may add their own
+ * routing metadata (aliases, fallback chains, anything else) as extensions,
+ * preserved via the index signature.
+ */
+export interface ModelDeck {
+    models: ModelInfo[];
+    /** Implementation extension fields (e.g. `aliases`, `waterfalls`). */
+    [extension: string]: unknown;
+}
+/**
+ * Verdict of `POST /validate` for a VALID bundle — the `is_valid: true` arm of
+ * the 200-diagnostic response union ({@link ValidationResult}).
+ *
+ * `/validate` is a diagnostic endpoint: every verdict it can produce — valid,
+ * invalid, or valid-but-not-runnable — rides a **200**, discriminated in the
+ * body on `is_valid`. Non-2xx is reserved for the cases where *no verdict could
+ * be produced* (a malformed request body, an `mthds_sources` length mismatch,
+ * auth, a server fault) — those surface as `ApiResponseError`. The protocol
+ * declares no further body fields; implementations may include their own
+ * artifacts (parsed structures, graphs, anything else), preserved here as
+ * extension fields.
+ */
+export interface ValidationReport {
+    /** Discriminant of the valid arm of the 200 response union. */
+    is_valid: true;
+    /** Implementation extension fields (e.g. `bundle_blueprint`, `graph_spec`, `pipe_io_contracts`, `validated_pipes`, `pending_signatures`, `is_runnable`). */
+    [extension: string]: unknown;
+}
+/**
+ * One structured diagnostic on an invalid verdict. The protocol fixes only the
+ * neutral `category` + `message`; an implementation narrows `category` to its own
+ * closed vocabulary and adds locators (see the Pipelex `ValidationErrorItem`,
+ * which extends this with `source`, `pipe_code`, `field_name`, and friends).
+ */
+export interface ValidationError {
+    category: string;
+    message: string;
+}
+/**
+ * Verdict of `POST /validate` for an INVALID bundle — the `is_valid: false` arm
+ * of the 200 response union.
+ *
+ * An invalid bundle is the *successful product* of a diagnostic call, not a
+ * transport failure (the request was well-formed; the bundle was not), so it
+ * rides a **200**. The structural artifacts of a valid report do not exist when
+ * load/parse/wiring failed, so this arm carries only the per-error diagnostics
+ * plus the runnability facts.
+ */
+export interface InvalidValidationReport {
+    /** Discriminant of the invalid arm. */
+    is_valid: false;
+    /** Per-error diagnostics — non-empty on every invalid verdict (even a parse-level failure yields one residual item). */
+    validation_errors: ValidationError[];
+    /** Outstanding signatures (best-effort; empty when no library could be assembled). */
+    pending_signatures: string[];
+    /** An invalid bundle is never runnable. */
+    is_runnable: false;
+    /** Human-readable summary of the verdict. */
+    message: string;
+}
+/**
+ * The discriminated 200 response of `POST /validate`, keyed on the mandatory
+ * `is_valid` field. A consumer pattern-matches that one field to learn the
+ * verdict — never inspecting a status code or catching an exception body. Only a
+ * *no-verdict* condition (non-2xx) throws.
+ */
+export type ValidationResult = ValidationReport | InvalidValidationReport;
+/**
+ * Protocol + runner versions — `GET /version` (always public).
+ *
+ * The handshake clients use for feature detection. The protocol defines two
+ * base fields (`protocol_version`, optional `runner_version`); implementations
+ * may add their own identification (an `implementation` name, an underlying
+ * runtime version, anything else) as extensions, preserved via the index
+ * signature and read by the api runner's bare-runner detection.
+ */
+export interface VersionInfo {
+    protocol_version: string;
+    runner_version?: string | null;
+    /**
+     * Implementation package version — the field clients gate capabilities on
+     * (e.g. the VS Code extension's `MIN_API_IMPLEMENTATION_VERSION`). An
+     * extension field (the protocol declares only `protocol_version` /
+     * `runner_version`), typed here as the one well-known extension so consumers
+     * gate on it without reaching through the untyped index signature. Absent on
+     * a runner that does not advertise it.
+     */
+    implementation_version?: string;
+    /** Further implementation extension fields (e.g. `implementation`, `runtime_version`). */
+    [extension: string]: unknown;
+}

package/dist/protocol/models.js

@@ -0,0 +1,24 @@
+/**
+ * Wire models for the MTHDS Protocol — exact mirror of `mthds/protocol/models.py`
+ * (which mirrors `mthds-protocol.openapi.yaml`, the standard's normative artifact).
+ *
+ *   POST /execute  : -> RunResultExecute (200: pipeline_run_id + pipe_output)
+ *   POST /start    : -> RunResultStart   (202: pipeline_run_id only)
+ *   POST /validate :              -> ValidationResult (200: discriminated on `is_valid`)
+ *   GET  /models   :              -> ModelDeck
+ *   GET  /version  :              -> VersionInfo
+ *
+ * Response models declare the protocol's BASE fields only and are
+ * extension-open: an implementation may return more, and those server-specific
+ * fields are preserved (via the index signature) — the response side of the
+ * same passthrough principle as the request-side `extra`.
+ */
+/** The MTHDS Protocol version this SDK implements (the MTHDS standard version). */
+export const MTHDS_PROTOCOL_VERSION = "0.6.0";
+export const MODEL_CATEGORIES = [
+    "llm",
+    "extract",
+    "img_gen",
+    "search",
+];
+//# sourceMappingURL=models.js.map

package/dist/protocol/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/protocol/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AA0C9C,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,KAAK;IACL,SAAS;IACT,SAAS;IACT,QAAQ;CACT,CAAC"}

package/dist/protocol/options.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The MTHDS Protocol's request-argument surface — the named arguments of
+ * `execute` / `start`.
+ *
+ * The protocol has no request *model*: a runner takes the request's basic
+ * arguments as named parameters and serializes the wire body directly, merging
+ * any server-specific extension args (`extra`) as top-level properties. These
+ * option/request shapes are the TS expression of that argument surface.
+ */
+import type { VariableMultiplicity } from "./pipe_output.js";
+import type { PipelineInputs } from "./pipeline_inputs.js";
+/**
+ * Body of the protocol's `POST /execute` — mirrors `RunRequest` in
+ * `mthds-protocol.openapi.yaml`. At least one of `pipe_code` /
+ * `mthds_contents` is required.
+ */
+export interface RunRequest {
+    /** Code of the pipe to execute (registered, or defined in `mthds_contents`). */
+    pipe_code?: string | null;
+    /** MTHDS bundle contents to load (always an array, even for one file). */
+    mthds_contents?: string[] | null;
+    /** Method inputs: map of input name to content (loose here, strict in the runtime). */
+    inputs?: PipelineInputs | Record<string, unknown> | null;
+    /** Name of the output slot to return as the main output. */
+    output_name?: string | null;
+    /** Output multiplicity override (`false`/`true` or an exact count). */
+    output_multiplicity?: VariableMultiplicity | null;
+    /** Override for the dynamic output concept reference. */
+    dynamic_output_concept_ref?: string | null;
+}
+/**
+ * Body of the protocol's `POST /start` — the same basic arguments as `RunRequest`.
+ *
+ * The protocol declares no start-only request fields. Anything an
+ * implementation accepts on top (a client-supplied run id, anything else) is
+ * an extension arg — the server that defines it is the one that handles it;
+ * callers pass it through the generic `extra` option.
+ */
+export type StartRequest = RunRequest;
+/**
+ * The generic extension passthrough: server-specific args merged into the
+ * request body as top-level properties — the server you call defines and
+ * handles them; this SDK only passes them through. Protocol args inside
+ * `extra` are rejected client-side.
+ */
+export interface ExtensionOptions {
+    extra?: Record<string, unknown> | null;
+}
+/**
+ * Options for `MTHDSProtocol.execute` — the `RunRequest` fields plus the
+ * generic `extra` extension passthrough. (The options surface and the wire
+ * body are intentionally the same shape.)
+ */
+export type RunOptions = RunRequest & ExtensionOptions;
+/**
+ * Options for `MTHDSProtocol.start` — the `StartRequest` wire fields (the
+ * protocol's basic execution arguments) plus the generic `extra` extension
+ * passthrough (server-specific args, merged into the body).
+ */
+export type StartOptions = StartRequest & ExtensionOptions;

package/dist/protocol/options.js

@@ -0,0 +1,11 @@
+/**
+ * The MTHDS Protocol's request-argument surface — the named arguments of
+ * `execute` / `start`.
+ *
+ * The protocol has no request *model*: a runner takes the request's basic
+ * arguments as named parameters and serializes the wire body directly, merging
+ * any server-specific extension args (`extra`) as top-level properties. These
+ * option/request shapes are the TS expression of that argument surface.
+ */
+export {};
+//# sourceMappingURL=options.js.map

package/dist/protocol/options.js.map

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

package/dist/protocol/pipe_output.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Pipe-output domain shapes — exact mirror of `mthds/protocol/pipe_output.py`
+ * (`VariableMultiplicity`, `PipeOutputAbstract`). The Dict-serialized concrete
+ * (`DictPipeOutput`) is runner-side (`runners/api/models.ts`).
+ */
+import type { WorkingMemoryAbstract } from "./working_memory.js";
+export type VariableMultiplicity = boolean | number;
+export interface PipeOutputAbstract<TWorkingMemory extends WorkingMemoryAbstract = WorkingMemoryAbstract> {
+    working_memory: TWorkingMemory;
+    pipeline_run_id: string;
+}

package/dist/protocol/pipe_output.js

@@ -0,0 +1,7 @@
+/**
+ * Pipe-output domain shapes — exact mirror of `mthds/protocol/pipe_output.py`
+ * (`VariableMultiplicity`, `PipeOutputAbstract`). The Dict-serialized concrete
+ * (`DictPipeOutput`) is runner-side (`runners/api/models.ts`).
+ */
+export {};
+//# sourceMappingURL=pipe_output.js.map

package/dist/protocol/pipe_output.js.map

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

package/dist/protocol/pipeline_inputs.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Pipeline input value shapes — exact mirror of `mthds/protocol/pipeline_inputs.py`
+ * (`StuffContentOrData`, `PipelineInputs`). The abstract input shapes only; the
+ * Dict-serialized concrete (`DictStuff`) is runner-side (`runners/api/models.ts`).
+ */
+import type { StuffContentAbstract } from "./stuff.js";
+export type StuffContentOrData = string | string[] | StuffContentAbstract | StuffContentAbstract[] | Record<string, unknown>;
+export type PipelineInputs = Record<string, StuffContentOrData>;

package/dist/protocol/pipeline_inputs.js

@@ -0,0 +1,7 @@
+/**
+ * Pipeline input value shapes — exact mirror of `mthds/protocol/pipeline_inputs.py`
+ * (`StuffContentOrData`, `PipelineInputs`). The abstract input shapes only; the
+ * Dict-serialized concrete (`DictStuff`) is runner-side (`runners/api/models.ts`).
+ */
+export {};
+//# sourceMappingURL=pipeline_inputs.js.map

package/dist/protocol/pipeline_inputs.js.map

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

package/dist/protocol/protocol.d.ts

@@ -0,0 +1,55 @@
+import type { RunOptions, StartOptions } from "./options.js";
+import type { ModelCategory, ModelDeck, RunResultExecute, RunResultStart, ValidationResult, VersionInfo } from "./models.js";
+/**
+ * The MTHDS Protocol — the contract every MTHDS runner implements. Exact
+ * mirror of `mthds/protocol/protocol.py` (`MTHDSProtocol`, generic in the
+ * pipe-output type).
+ *
+ * Mirrors the standard's five routes (`mthds-protocol.openapi.yaml`):
+ * `execute`, `start`, `validate`, `models`, `version`. A runner is just a
+ * runner: it executes and validates methods, and reports its model deck and
+ * version. Run polling is NOT part of the protocol — it is a hosted-API
+ * extension carried by `MthdsApiClient` and the `Runner` interface only.
+ *
+ * Generic in `PipeOutputT` (mirroring python's `Generic[PipeOutputT]`): the
+ * generic is the mechanism that keeps `protocol/` pure — `execute` returns
+ * `RunResultExecute<PipeOutputT>` without the protocol ever naming the
+ * runner-side `DictPipeOutput` concrete.
+ */
+export interface MTHDSProtocol<PipeOutputT = unknown> {
+    /**
+     * Execute a method synchronously and wait for its completion.
+     *
+     * Throws `RunStillRunningError` if the server answers 202 (the
+     * protocol's optional async degrade) instead of a final result.
+     */
+    execute(options: RunOptions): Promise<RunResultExecute<PipeOutputT>>;
+    /**
+     * Start a method asynchronously without waiting for completion.
+     *
+     * Carries the protocol's basic arguments only; server-specific extension
+     * args ride `options.extra`. Returns `RunResultStart` — the authoritative
+     * server-generated `pipeline_run_id`, no output yet.
+     */
+    start(options: StartOptions): Promise<RunResultStart>;
+    /**
+     * Parse, validate, and dry-run an MTHDS bundle.
+     *
+     * `/validate` is a diagnostic endpoint: it returns a {@link ValidationResult}
+     * discriminated on `is_valid` — the structural artifacts of a VALID bundle, or
+     * the `validation_errors[]` of an INVALID one. An invalid bundle is a produced
+     * verdict (a 200 on API runners), NOT a thrown error; only a *no-verdict*
+     * condition (a malformed request, auth, a server fault) throws. `allowSignatures`
+     * tolerates unimplemented pipe signatures (strict by default) — they surface as
+     * `pending_signatures` + `is_runnable`, never as an error.
+     *
+     * (A local CLI runner may instead raise on an invalid bundle rather than
+     * materialize the invalid arm — the union is the wire shape, not a guarantee
+     * that every runtime returns both arms.)
+     */
+    validate(mthdsContents: string[], allowSignatures?: boolean): Promise<ValidationResult>;
+    /** The model deck this runner can route to, optionally filtered by category. */
+    models(category?: ModelCategory): Promise<ModelDeck>;
+    /** Protocol + implementation versions — the handshake for feature detection. */
+    version(): Promise<VersionInfo>;
+}

package/dist/{client → protocol}/protocol.js.map

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

package/dist/protocol/stuff.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Stuff domain shapes — exact mirror of `mthds/protocol/stuff.py`
+ * (`StuffAbstract`, `StuffContentAbstract`). The protocol-level abstract stuff;
+ * the Dict-serialized concrete (`DictStuff`) is runner-side
+ * (`runners/api/models.ts`).
+ */
+import type { ConceptAbstract } from "./concept.js";
+/** Marker base for a stuff's content payload (mirrors python `StuffContentAbstract`). */
+export interface StuffContentAbstract {
+}
+export interface StuffAbstract<TConcept extends ConceptAbstract = ConceptAbstract, TContent extends StuffContentAbstract = StuffContentAbstract> {
+    stuff_code: string;
+    stuff_name?: string | null;
+    concept: TConcept;
+    content: TContent;
+}

package/dist/protocol/stuff.js

@@ -0,0 +1,8 @@
+/**
+ * Stuff domain shapes — exact mirror of `mthds/protocol/stuff.py`
+ * (`StuffAbstract`, `StuffContentAbstract`). The protocol-level abstract stuff;
+ * the Dict-serialized concrete (`DictStuff`) is runner-side
+ * (`runners/api/models.ts`).
+ */
+export {};
+//# sourceMappingURL=stuff.js.map

package/dist/{client/models → protocol}/stuff.js.map

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

package/dist/protocol/working_memory.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Working-memory domain shape — exact mirror of `mthds/protocol/working_memory.py`
+ * (`WorkingMemoryAbstract`). The Dict-serialized concrete (`DictWorkingMemory`)
+ * is runner-side (`runners/api/models.ts`).
+ */
+import type { StuffAbstract } from "./stuff.js";
+export interface WorkingMemoryAbstract<TStuff extends StuffAbstract = StuffAbstract> {
+    root: Record<string, TStuff>;
+    aliases: Record<string, string>;
+}