mthds 0.10.0 → 0.12.0

package/dist/agent/output.d.ts

@@ -21,9 +21,21 @@ export type AgentErrorDomain = (typeof AGENT_ERROR_DOMAINS)[keyof typeof AGENT_E
 export declare const AGENT_ERROR_HINTS: Record<string, string>;
 export type { BinaryRecoveryInfo };
 export declare function agentSuccess(result: Record<string, unknown>): void;
+/** Emit a server-rendered Markdown success to stdout (exit 0) — the `--format markdown` valid arm. */
+export declare function agentMarkdownSuccess(markdown: string): void;
+/**
+ * Emit a server-rendered Markdown failure to stderr + `process.exit(1)` — the
+ * `--format markdown` invalid arm (a produced negative verdict). Mirrors the
+ * local CLI, which writes the failure Markdown to stderr and exits non-zero.
+ */
+export declare function agentMarkdownError(markdown: string): never;
 export declare function agentError(message: string, errorType: string, extras?: {
     hint?: string;
     error_domain?: AgentErrorDomain;
     retryable?: boolean;
     recovery?: BinaryRecoveryInfo;
+    /** Verdict discriminant on a validate failure — `false` rides the envelope (mirrors the Python agent CLI). */
+    is_valid?: boolean;
+    /** Structured per-error diagnostics on an invalid-bundle verdict (the `/validate` 200 InvalidReport arm). */
+    validation_errors?: unknown[];
 }): never;

package/dist/agent/output.js

@@ -24,6 +24,7 @@ export const AGENT_ERROR_HINTS = {
     ConfigError: "Run `mthds-agent config list` to see current configuration.",
     RunnerError: "Check that the runner is properly configured.",
     ValidationError: "Check the .mthds bundle for syntax or schema errors.",
+    ValidateBundleError: "The bundle is invalid — see validation_errors for the per-error diagnostics.",
     InstallError: "Check the address and try again.",
     PackageError: "Check the METHODS.toml file and try again.",
 };
@@ -31,6 +32,20 @@ export const AGENT_ERROR_HINTS = {
 export function agentSuccess(result) {
     process.stdout.write(JSON.stringify(result, null, 2) + "\n");
 }
+// ── Markdown output (validate --format markdown) ──────────────────────
+/** Emit a server-rendered Markdown success to stdout (exit 0) — the `--format markdown` valid arm. */
+export function agentMarkdownSuccess(markdown) {
+    process.stdout.write(markdown.endsWith("\n") ? markdown : markdown + "\n");
+}
+/**
+ * Emit a server-rendered Markdown failure to stderr + `process.exit(1)` — the
+ * `--format markdown` invalid arm (a produced negative verdict). Mirrors the
+ * local CLI, which writes the failure Markdown to stderr and exits non-zero.
+ */
+export function agentMarkdownError(markdown) {
+    process.stderr.write(markdown.endsWith("\n") ? markdown : markdown + "\n");
+    process.exit(1);
+}
 // ── Error output ─────────────────────────────────────────────────────
 export function agentError(message, errorType, extras) {
     const payload = {
@@ -46,6 +61,12 @@ export function agentError(message, errorType, extras) {
     if (extras?.recovery) {
         payload.recovery = extras.recovery;
     }
+    if (extras?.is_valid !== undefined) {
+        payload.is_valid = extras.is_valid;
+    }
+    if (extras?.validation_errors !== undefined) {
+        payload.validation_errors = extras.validation_errors;
+    }
     // Remove undefined values for cleaner output
     for (const key of Object.keys(payload)) {
         if (payload[key] === undefined) {

package/dist/agent/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/agent/output.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wEAAwE;AAExE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;IAClB,EAAE,EAAE,IAAI;IACR,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACV,CAAC;AAKX,wEAAwE;AAExE,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,mBAAmB,EACjB,kEAAkE;IACpE,aAAa,EAAE,4CAA4C;IAC3D,WAAW,EAAE,6DAA6D;IAC1E,WAAW,EAAE,+CAA+C;IAC5D,eAAe,EAAE,sDAAsD;IACvE,YAAY,EAAE,kCAAkC;IAChD,YAAY,EACV,4CAA4C;CAC/C,CAAC;AAKF,wEAAwE;AAExE,MAAM,UAAU,YAAY,CAAC,MAA+B;IAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,wEAAwE;AAExE,MAAM,UAAU,UAAU,CACxB,OAAe,EACf,SAAiB,EACjB,MAKC;IAED,MAAM,OAAO,GAA4B;QACvC,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,SAAS;QACrB,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,iBAAiB,CAAC,SAAS,CAAC,IAAI,SAAS;QAC/D,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,SAAS;KAChD,CAAC;IACF,IAAI,MAAM,EAAE,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAC3B,CAAC;IACD,IAAI,MAAM,EAAE,QAAQ,EAAE,CAAC;QACrB,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACrC,CAAC;IAED,6CAA6C;IAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/agent/output.ts"],"names":[],"mappings":"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"}

package/dist/agent/plugin-version.d.ts

@@ -11,7 +11,7 @@
  */
 import type { BinaryCheckEntry } from "./update-cache.js";
 /** Minimum plugin version this mthds-agent release requires. */
-export declare const MIN_PLUGIN_VERSION = ">=0.12.0";
+export declare const MIN_PLUGIN_VERSION = ">=0.14.0";
 /** Keys in installed_plugins.json for the mthds plugin (prod and dev targets). */
 export declare const PLUGIN_KEYS: readonly ["mthds@mthds-plugins", "mthds-dev@mthds-plugins"];
 /** Path to Claude Code's installed plugins registry. */

package/dist/agent/plugin-version.js

@@ -15,7 +15,7 @@ import { homedir } from "node:os";
 import semver from "semver";
 // ── Constants ──────────────────────────────────────────────────────
 /** Minimum plugin version this mthds-agent release requires. */
-export const MIN_PLUGIN_VERSION = ">=0.12.0";
+export const MIN_PLUGIN_VERSION = ">=0.14.0";
 /** Keys in installed_plugins.json for the mthds plugin (prod and dev targets). */
 export const PLUGIN_KEYS = [
     "mthds@mthds-plugins",

package/dist/cli/commands/install.js

@@ -152,10 +152,22 @@ export async function installMethod(options) {
             }
             valSpinner.start(`Validating ${method.name}...`);
             try {
-                await runner.validate(contents);
+                const report = await runner.validate(contents);
+                if (report.is_valid === false) {
+                    // A produced "invalid" verdict (the 200 InvalidReport arm) — surface the
+                    // per-error diagnostics, not just the summary, so failures are debuggable.
+                    valSpinner.stop(`Validation failed: ${method.name}`);
+                    p.log.error(`${method.name}: ${report.message}`);
+                    for (const item of report.validation_errors) {
+                        p.log.error(`  [${item.category}] ${item.message}`);
+                    }
+                    allValid = false;
+                    continue;
+                }
                 valSpinner.stop(`Validated ${method.name}`);
             }
             catch (err) {
+                // A no-verdict condition (a local CLI runner raising, or a transport fault).
                 valSpinner.stop(`Validation failed: ${method.name}`);
                 p.log.error(`${method.name}: ${err.message}`);
                 allValid = false;

package/dist/cli/commands/install.js.map

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

package/dist/cli/commands/utils.d.ts

@@ -1,7 +1,15 @@
 export declare function maskApiKey(key: string): string;
 import { PipelexRunner } from "../../runners/pipelex/runner.js";
+import { MthdsApiClient } from "../../runners/api/client.js";
 import type { Runner } from "../../runners/types.js";
 export declare function isPipelexRunner(runner: Runner): runner is PipelexRunner;
+/**
+ * Narrow to the concrete API client. The `mthds_sources` per-content attribution
+ * argument is a Pipelex-API extension (not part of the pure `MTHDSProtocol`), so
+ * reaching it requires the concrete client — this guard is the type-safe way to
+ * do that without polluting the protocol interface.
+ */
+export declare function isApiRunner(runner: Runner): runner is MthdsApiClient;
 /**
  * Extract raw args after a given command keyword, filtering out
  * --runner / -L / --library-dir (consumed by mthds, not forwarded).

package/dist/cli/commands/utils.js

@@ -9,6 +9,15 @@ import { Runners } from "../../runners/types.js";
 export function isPipelexRunner(runner) {
     return runner.type === Runners.PIPELEX;
 }
+/**
+ * Narrow to the concrete API client. The `mthds_sources` per-content attribution
+ * argument is a Pipelex-API extension (not part of the pure `MTHDSProtocol`), so
+ * reaching it requires the concrete client — this guard is the type-safe way to
+ * do that without polluting the protocol interface.
+ */
+export function isApiRunner(runner) {
+    return runner.type === Runners.API;
+}
 /**
  * Extract raw args after a given command keyword, filtering out
  * --runner / -L / --library-dir (consumed by mthds, not forwarded).

package/dist/cli/commands/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/cli/commands/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC,GAAG;QAAE,OAAO,WAAW,CAAC;IAC7B,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;AAC3D,CAAC;AAGD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGjD,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,SAAiB;IACvE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;IACvD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QACpB,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB;QAC9B,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC3E,CAAC,IAAI,CAAC,CAAC,CAAC,2BAA2B;QACrC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/cli/commands/utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC,GAAG;QAAE,OAAO,WAAW,CAAC;IAC7B,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;AAC3D,CAAC;AAID,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGjD,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,GAAG,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,SAAiB;IACvE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;IACvD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QACpB,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB;QAC9B,CAAC;aAAM,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC3E,CAAC,IAAI,CAAC,CAAC,CAAC,2BAA2B;QACrC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/commands/validate.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import * as p from "@clack/prompts";
 import { printLogo } from "./index.js";
-import { isPipelexRunner, extractPassthroughArgs } from "./utils.js";
+import { isPipelexRunner, isApiRunner, extractPassthroughArgs } from "./utils.js";
 import { createRunner } from "../../runners/registry.js";
 async function validateWithPipelexPassthrough(introLabel, fallbackMsg, options) {
     printLogo();
@@ -80,12 +80,32 @@ export async function validatePipe(target, options) {
     const s = p.spinner();
     s.start("Validating...");
     try {
-        await runner.validate([mthdsContent]);
+        // Name the submitted file so cross-file diagnostics resolve the owning file.
+        // `mthds_sources` is a Pipelex-API extension carried only by the concrete
+        // client (not the pure protocol) — reach it through `isApiRunner`.
+        const report = isApiRunner(runner)
+            ? await runner.validate([mthdsContent], false, [bundlePath])
+            : await runner.validate([mthdsContent]);
+        if (report.is_valid === false) {
+            // A produced "invalid" verdict (the 200 InvalidReport arm) — report the
+            // diagnostics and exit non-zero, rather than mistaking a 200 for success.
+            s.stop("Validation failed.");
+            p.log.error(report.message);
+            for (const item of report.validation_errors) {
+                // The server attributes `source` from `mthds_sources`; fall back to the
+                // path the user passed so a diagnostic always names its file.
+                const source = item.source ?? bundlePath;
+                p.log.error(`${source}: [${item.category}] ${item.message}`);
+            }
+            p.outro("");
+            process.exit(1);
+        }
         s.stop("Validation passed.");
         p.log.success("MTHDS content validated successfully");
         p.outro("Done");
     }
     catch (err) {
+        // A no-verdict condition (a local CLI runner raising, or a transport fault).
         s.stop("Validation failed.");
         p.log.error(err.message);
         p.outro("");

package/dist/cli/commands/validate.js.map

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

package/dist/index.d.ts

@@ -15,7 +15,7 @@ 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, VersionInfo, } 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";
@@ -24,4 +24,4 @@ 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, } from "./runners/api/models.js";
+export type { DictStuff, DictWorkingMemory, DictPipeOutput, DictRunResultExecute, PipelexValidationReport, PipelexInvalidReport, PipelexValidationResult, ValidatedPipeEntry, DryRunStatus, ValidationErrorItem, ValidationErrorCategory, } from "./runners/api/models.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"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;AAahF,yEAAyE;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKnD,yEAAyE;AACzE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,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/models.d.ts

@@ -4,7 +4,7 @@
  *
  *   POST /execute  : -> RunResultExecute (200: pipeline_run_id + pipe_output)
  *   POST /start    : -> RunResultStart   (202: pipeline_run_id only)
- *   POST /validate :              -> ValidationReport
+ *   POST /validate :              -> ValidationResult (200: discriminated on `is_valid`)
  *   GET  /models   :              -> ModelDeck
  *   GET  /version  :              -> VersionInfo
  *
@@ -67,17 +67,63 @@ export interface ModelDeck {
     [extension: string]: unknown;
 }
 /**
- * Verdict of `POST /validate` for a VALID bundle — the 200 status IS the verdict.
+ * Verdict of `POST /validate` for a VALID bundle — the `is_valid: true` arm of
+ * the 200-diagnostic response union ({@link ValidationResult}).
  *
- * Failures never reach this shape — they are RFC 7807 problems (HTTP 422,
- * surfaced as `ApiResponseError`). The protocol declares no body fields;
- * implementations may include their own artifacts (parsed structures, graphs,
- * anything else), preserved here as extension fields.
+ * `/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 {
-    /** Implementation extension fields (e.g. `blueprint`, `graph_spec`, `pipe_structures`). */
+    /** 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).
  *
@@ -90,6 +136,15 @@ export interface ValidationReport {
 export interface VersionInfo {
     protocol_version: string;
     runner_version?: string | null;
-    /** Implementation extension fields (e.g. `implementation`, `runtime_version`). */
+    /**
+     * 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

@@ -4,7 +4,7 @@
  *
  *   POST /execute  : -> RunResultExecute (200: pipeline_run_id + pipe_output)
  *   POST /start    : -> RunResultStart   (202: pipeline_run_id only)
- *   POST /validate :              -> ValidationReport
+ *   POST /validate :              -> ValidationResult (200: discriminated on `is_valid`)
  *   GET  /models   :              -> ModelDeck
  *   GET  /version  :              -> VersionInfo
  *

package/dist/protocol/protocol.d.ts

@@ -1,5 +1,5 @@
 import type { RunOptions, StartOptions } from "./options.js";
-import type { ModelCategory, ModelDeck, RunResultExecute, RunResultStart, ValidationReport, VersionInfo } from "./models.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
@@ -35,11 +35,19 @@ export interface MTHDSProtocol<PipeOutputT = unknown> {
     /**
      * Parse, validate, and dry-run an MTHDS bundle.
      *
-     * Returns the structural artifacts of a VALID bundle; invalid bundles throw
-     * (HTTP 422 problem on API runners). `allowSignatures` tolerates
-     * unimplemented pipe signatures (strict by default).
+     * `/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<ValidationReport>;
+    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. */

package/dist/runners/api/client.d.ts

@@ -1,8 +1,8 @@
 import { BaseRunner } from "../base-runner.js";
 import type { Runner, RunnerType, BuildInputsRequest, BuildOutputRequest, BuildRunnerRequest, BuildRunnerResponse, ConceptRequest, ConceptResponse, PipeSpecRequest, PipeSpecResponse } from "../types.js";
 import type { RunOptions, StartOptions } from "../../protocol/options.js";
-import type { ModelCategory, ModelDeck, RunResultStart, ValidationReport, VersionInfo } from "../../protocol/models.js";
-import type { DictRunResultExecute } from "./models.js";
+import type { ModelCategory, ModelDeck, RunResultStart, VersionInfo } from "../../protocol/models.js";
+import type { DictRunResultExecute, PipelexValidationResult } from "./models.js";
 import type { RunRead, RunResults, RunResultState, WaitForResultOptions } from "./runs.js";
 interface MthdsApiClientOptions {
     /** API token (Bearer). Falls back to `MTHDS_API_KEY`. Optional for anonymous bare runners. */
@@ -99,10 +99,26 @@ export declare class MthdsApiClient extends BaseRunner implements Runner {
     /**
      * Parse, validate, and dry-run an MTHDS bundle — `POST /v1/validate`.
      *
-     * Returns the structural artifacts of a valid bundle; an invalid bundle is
-     * an HTTP 422 problem, surfaced as `ApiResponseError`.
+     * `/validate` is a diagnostic endpoint: every produced verdict rides a **200**,
+     * discriminated on `is_valid`. This returns the `PipelexValidationResult` union
+     * verbatim — `is_valid: true` ⇒ the typed `PipelexValidationReport` (structural
+     * artifacts), `is_valid: false` ⇒ a `PipelexInvalidReport` (`validation_errors[]`).
+     * An invalid bundle is NOT thrown — the caller pattern-matches `is_valid`. Only a
+     * *no-verdict* condition (a malformed request, an `mthds_sources` length mismatch,
+     * auth, a server fault) is non-2xx and surfaces as `ApiResponseError`.
+     *
+     * `mthdsSources` (optional, parallel to `mthdsContents`) names each submitted
+     * content — a Pipelex-API extension threaded onto `blueprint.source`, so
+     * cross-file diagnostics name the owning file (an unnamed content yields
+     * `source: null`). The server 422s a length mismatch; this client sends the
+     * arrays verbatim and surfaces that as an `ApiResponseError`.
+     *
+     * `render` (optional) is the opt-in Pipelex-API presentation hint — a list of
+     * view-format tokens (e.g. `["markdown"]`). When set, the 200 body gains a
+     * `rendered_markdown` field on both verdict arms; unknown tokens are server-side
+     * lenient-ignored (never a 422). Omit it for the lean structured-only response.
      */
-    validate(mthdsContents: string[], allowSignatures?: boolean): Promise<ValidationReport>;
+    validate(mthdsContents: string[], allowSignatures?: boolean, mthdsSources?: string[], render?: string[]): Promise<PipelexValidationResult>;
     /** The model deck the runner can route to — `GET /v1/models[?type=]`. */
     models(category?: ModelCategory): Promise<ModelDeck>;
     /**

package/dist/runners/api/client.js

@@ -160,8 +160,8 @@ export class MthdsApiClient extends BaseRunner {
         return this.requestJson("POST", this.url(path), body);
     }
     throwApiResponseError(method, endpoint, res) {
-        const { errorType, serverMessage } = parseErrorBody(res.body);
-        throw new ApiResponseError(`API ${method} /${API_PREFIX}/${endpoint} failed (${res.status}): ${serverMessage ?? (res.body || res.statusText)}`, this.baseUrl, res.status, res.statusText, res.body, errorType, serverMessage);
+        const { errorType, serverMessage, validationErrors } = parseErrorBody(res.body);
+        throw new ApiResponseError(`API ${method} /${API_PREFIX}/${endpoint} failed (${res.status}): ${serverMessage ?? (res.body || res.statusText)}`, this.baseUrl, res.status, res.statusText, res.body, errorType, serverMessage, validationErrors);
     }
     /**
      * Translate a "route absent" 404 (a bare pipelex-api with no platform block)
@@ -300,13 +300,37 @@ export class MthdsApiClient extends BaseRunner {
     /**
      * Parse, validate, and dry-run an MTHDS bundle — `POST /v1/validate`.
      *
-     * Returns the structural artifacts of a valid bundle; an invalid bundle is
-     * an HTTP 422 problem, surfaced as `ApiResponseError`.
+     * `/validate` is a diagnostic endpoint: every produced verdict rides a **200**,
+     * discriminated on `is_valid`. This returns the `PipelexValidationResult` union
+     * verbatim — `is_valid: true` ⇒ the typed `PipelexValidationReport` (structural
+     * artifacts), `is_valid: false` ⇒ a `PipelexInvalidReport` (`validation_errors[]`).
+     * An invalid bundle is NOT thrown — the caller pattern-matches `is_valid`. Only a
+     * *no-verdict* condition (a malformed request, an `mthds_sources` length mismatch,
+     * auth, a server fault) is non-2xx and surfaces as `ApiResponseError`.
+     *
+     * `mthdsSources` (optional, parallel to `mthdsContents`) names each submitted
+     * content — a Pipelex-API extension threaded onto `blueprint.source`, so
+     * cross-file diagnostics name the owning file (an unnamed content yields
+     * `source: null`). The server 422s a length mismatch; this client sends the
+     * arrays verbatim and surfaces that as an `ApiResponseError`.
+     *
+     * `render` (optional) is the opt-in Pipelex-API presentation hint — a list of
+     * view-format tokens (e.g. `["markdown"]`). When set, the 200 body gains a
+     * `rendered_markdown` field on both verdict arms; unknown tokens are server-side
+     * lenient-ignored (never a 422). Omit it for the lean structured-only response.
      */
-    async validate(mthdsContents, allowSignatures = false) {
-        const res = await this.requestRaw("POST", this.url("validate"), {
-            body: { mthds_contents: mthdsContents, allow_signatures: allowSignatures },
-        });
+    async validate(mthdsContents, allowSignatures = false, mthdsSources, render) {
+        const body = {
+            mthds_contents: mthdsContents,
+            allow_signatures: allowSignatures,
+        };
+        if (mthdsSources !== undefined) {
+            body.mthds_sources = mthdsSources;
+        }
+        if (render !== undefined && render.length > 0) {
+            body.render = render;
+        }
+        const res = await this.requestRaw("POST", this.url("validate"), { body });
         if (res.status < 200 || res.status >= 300) {
             this.throwApiResponseError("POST", "validate", res);
         }
@@ -614,21 +638,24 @@ function extractRunStatusFromMessage(message) {
 /**
  * The API serializes errors as `{"detail": {"error_type": ..., "message": ...}}`
  * (HTTPException with dict detail) or `{"detail": "..."}` (auth 401s and RFC
- * 7807 problems). Both shapes are extracted here. Falls through silently on
- * non-JSON bodies.
+ * 7807 problems). Both shapes are extracted here. An invalid-bundle 422 problem
+ * additionally carries a top-level `validation_errors[]` list (the
+ * `ValidateBundleError` extension projected onto the envelope). Falls through
+ * silently on non-JSON bodies.
  */
 function parseErrorBody(body) {
+    const empty = { errorType: undefined, serverMessage: undefined, validationErrors: undefined };
     if (!body)
-        return { errorType: undefined, serverMessage: undefined };
+        return empty;
     let parsed;
     try {
         parsed = JSON.parse(body);
     }
     catch {
-        return { errorType: undefined, serverMessage: undefined };
+        return empty;
     }
     if (!parsed || typeof parsed !== "object") {
-        return { errorType: undefined, serverMessage: undefined };
+        return empty;
     }
     const root = parsed;
     const detail = root.detail;
@@ -648,6 +675,13 @@ function parseErrorBody(body) {
         errorType = root.error_type;
     if (serverMessage === undefined && typeof root.message === "string")
         serverMessage = root.message;
-    return { errorType, serverMessage };
+    // `validation_errors` rides the problem envelope as a top-level array (the
+    // VERBOSE projection of `ErrorReport.validation_errors`, retained under STRICT
+    // too — it describes the caller's own bundle, not server internals). Kept as a
+    // shallow array guard; per-item shape is the typed `ValidationErrorItem` contract.
+    const validationErrors = Array.isArray(root.validation_errors)
+        ? root.validation_errors
+        : undefined;
+    return { errorType, serverMessage, validationErrors };
 }
 //# sourceMappingURL=client.js.map