mthds 0.13.0 → 0.14.0

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Client-safe error taxonomy — the SDK's exception classes, exported from a
+ * module whose graph has NO Node-only dependencies, so it can be imported from a
+ * browser/client bundle. Published as the `mthds/errors` subpath.
+ *
+ * Why a separate entry: the top-level barrel (`mthds`) statically re-exports
+ * `MthdsApiClient`, whose graph pulls `config/` → `node:fs` at module load. A
+ * client bundler (e.g. Next.js / Turbopack) cannot externalize `node:fs` and
+ * fails the build — even when the consumer only wanted an error class for an
+ * `instanceof` check. Code that needs to classify an error on the client (e.g.
+ * `err instanceof ApiResponseError`) imports the classes from here instead of
+ * the top-level barrel.
+ *
+ * These are the same error classes the top-level barrel exports; the two cannot
+ * drift because both re-export from the same source modules. The graph here is
+ * `protocol/exceptions` (zero imports) + `runners/api/exceptions` (whose only
+ * runtime import is `protocol/exceptions`), so it stays free of Node built-ins.
+ */
+export { PipelineRequestError } from "./protocol/exceptions.js";
+export { ApiResponseError, ApiUnreachableError, ClientAuthenticationError, PipelineExecuteTimeoutError, RunStillRunningError, } from "./runners/api/exceptions.js";

package/dist/errors.js

@@ -0,0 +1,23 @@
+/**
+ * Client-safe error taxonomy — the SDK's exception classes, exported from a
+ * module whose graph has NO Node-only dependencies, so it can be imported from a
+ * browser/client bundle. Published as the `mthds/errors` subpath.
+ *
+ * Why a separate entry: the top-level barrel (`mthds`) statically re-exports
+ * `MthdsApiClient`, whose graph pulls `config/` → `node:fs` at module load. A
+ * client bundler (e.g. Next.js / Turbopack) cannot externalize `node:fs` and
+ * fails the build — even when the consumer only wanted an error class for an
+ * `instanceof` check. Code that needs to classify an error on the client (e.g.
+ * `err instanceof ApiResponseError`) imports the classes from here instead of
+ * the top-level barrel.
+ *
+ * These are the same error classes the top-level barrel exports; the two cannot
+ * drift because both re-export from the same source modules. The graph here is
+ * `protocol/exceptions` (zero imports) + `runners/api/exceptions` (whose only
+ * runtime import is `protocol/exceptions`), so it stays free of Node built-ins.
+ */
+// ── Protocol-base error (pure protocol layer — no Node deps) ──
+export { PipelineRequestError } from "./protocol/exceptions.js";
+// ── API-runner errors (runners/api/exceptions — graph is protocol-only) ──
+export { ApiResponseError, ApiUnreachableError, ClientAuthenticationError, PipelineExecuteTimeoutError, RunStillRunningError, } from "./runners/api/exceptions.js";
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,iEAAiE;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,4EAA4E;AAC5E,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,6BAA6B,CAAC"}

package/dist/installer/runtime/installer.d.ts

@@ -9,7 +9,7 @@ export declare function isUvInstalled(): boolean;
 export declare function installUv(): void;
 /**
  * Ensure pipelex is installed, using uv tool install with spinner feedback.
- * Used by interactive CLI commands (mthds install, mthds setup, etc.).
+ * Used by interactive CLI commands (mthds install, mthds runner setup, etc.).
  */
 export declare function ensureRuntime(): Promise<void>;
 /**

package/dist/installer/runtime/installer.js

@@ -51,7 +51,7 @@ export function installUv() {
 // ── Async install (interactive, with spinner) ────────────────────────
 /**
  * Ensure pipelex is installed, using uv tool install with spinner feedback.
- * Used by interactive CLI commands (mthds install, mthds setup, etc.).
+ * Used by interactive CLI commands (mthds install, mthds runner setup, etc.).
  */
 export async function ensureRuntime() {
     if (!isPipelexInstalled()) {

package/dist/protocol/protocol.d.ts

@@ -9,7 +9,8 @@ import type { ModelCategory, ModelDeck, RunResultExecute, RunResultStart, Valida
  * `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.
+ * extension that now lives in the Pipelex runtime SDK (`@pipelex/sdk` /
+ * `pipelex-agent`), not in this package.
  *
  * Generic in `PipeOutputT` (mirroring python's `Generic[PipeOutputT]`): the
  * generic is the mechanism that keeps `protocol/` pure — `execute` returns

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mthds",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "CLI and SDK for MTHDS — the open standard for executable AI methods. Install, execute, and manage methods.",
   "license": "MIT",
   "repository": {
@@ -18,6 +18,10 @@
     "./protocol": {
       "import": "./dist/protocol/index.js",
       "types": "./dist/protocol/index.d.ts"
+    },
+    "./errors": {
+      "import": "./dist/errors.js",
+      "types": "./dist/errors.d.ts"
     }
   },
   "bin": {
@@ -42,7 +46,7 @@
     "dist/"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "dependencies": {
     "@clack/prompts": "^1.0.0",