@pipelex/sdk 0.34.0 → 0.35.0

package/README.md

@@ -6,7 +6,7 @@ TypeScript SDK for the **Pipelex hosted API** — execute MTHDS methods, manage
 
 ## Status
 
-Early. `PipelexApiClient` implements the MTHDS protocol-execution routes (`execute` / `start` / `validate` / `models` / `version`), the crate routes (`resolve` / `codegen` / `pipeIo`), the durable run lifecycle (`start` → poll → result), and the Pipelex product routes (user profile, methods catalog, organizations, billing, API keys, onboarding, storage, runs list/update).
+Early. `PipelexApiClient` implements the MTHDS protocol-execution routes (`execute` / `start` / `validate` / `models` / `version`), the crate routes (`resolve` / `codegen` / `pipeIo`), the model reference check (`checkModelReference`), the durable run lifecycle (`start` → poll → result), and the Pipelex product routes (user profile, methods catalog, organizations, billing, API keys, onboarding, storage, runs list/update).
 
 Besides the client, the package exports `runCodegenCheck` — a **pure** offline check that verifies a committed `codegen()` tree still matches its `codegen.lock`. It needs no server, no key, and no client instance, so it fits a CI job. See [`docs/crate-routes.md`](./docs/crate-routes.md#the-offline-check--runcodegencheck).
 
@@ -27,7 +27,7 @@ npx @pipelex/sdk run --method github.com/acme/methods/receipt-review@v1.0.0 --in
 npx @pipelex/sdk run --method github.com/acme/methods/receipt-review@v1.0.0 --inputs inputs.json
 ```
 
-`--method` takes a published address, a catalog id (`mt_…`) or a local `.mthds` file or bundle directory. The run's main output is printed on stdout as JSON, and the run id, each uploaded file and every error on stderr. `script` writes a method its own command, a shell script pinned to this SDK's version:
+`--method` takes a published address, a catalog id (`mt_…`, which runs the method's latest published version, `mt_…@<n>` for a fixed version or `mt_…@draft` for its draft) or a local `.mthds` file or bundle directory. The run's main output is printed on stdout as JSON, and the run id, each uploaded file and every error on stderr. `script` writes a method its own command, a shell script pinned to this SDK's version:
 
 ```bash
 npx @pipelex/sdk script --method github.com/acme/methods/receipt-review@v1.0.0
@@ -65,14 +65,38 @@ const ack = await client.start({
   inputs: { document: { url: "https://example.com/report.pdf" } },
 });
 console.log(ack.method_provenance); // { address, tag, commit_sha }
+
+// Or run a saved method by its catalog id. A bare id runs its latest published version,
+// `mt_…@3` version 3 and `mt_…@draft` its draft; the ack says which version runs.
+const saved = await client.start({ method_id: "mt_abc123@3", inputs: {} });
+console.log(saved.method_version); // 3
+```
+
+### Checking a model reference
+
+`checkModelReference` asks the runner whether a reference a method's `model` field could name resolves, as what kind and to which model (`GET /v1/models/check`, served by `pipelex-api` from pipelex 0.78.0). A reference that resolves nowhere is a verdict, not an error, and narrowing on `kind` types its `matches`:
+
+```ts
+const verdict = await client.checkModelReference("$writing-factual", "llm");
+if (verdict.resolution === "resolved") {
+  for (const match of verdict.matches) {
+    // `resolves_to` is null when the name exists but a run through it would reach no model.
+    console.log(match.category, match.resolves_to ?? "warning: no model the runner can call");
+  }
+  if (verdict.kind === "preset") console.log(verdict.matches[0]?.description);
+} else {
+  console.log(verdict.other_kinds, verdict.suggestions); // what the caller may have meant
+}
 ```
 
+A reference the runner cannot read at all (blank, a sigil alone, too long) or an unknown category throws `ApiResponseError`, a `422` whose `errorType` is `InvalidModelReference` or `InvalidModelCategory`.
+
 ### Product routes
 
 The hosted management surface (catalog, account, billing) hangs off the same client. Every route maps a non-2xx `problem+json` to a typed `ApiResponseError` (see [Errors](#errors) for how to branch on it):
 
 ```ts
-import { PipelexApiClient, ApiResponseError } from "@pipelex/sdk";
+import { PipelexApiClient, ApiResponseError, parseMethodSelector } from "@pipelex/sdk";
 
 const client = new PipelexApiClient({ apiKey: process.env.PIPELEX_API_KEY });
 
@@ -83,6 +107,21 @@ for await (const method of client.iterateMethods()) {
 }
 const created = await client.createMethod({ name: "Greeter", mthds: "domain = 'demo'" });
 
+// A saved method has a draft, written freely and never validated, and immutable published
+// versions. `updated_at` is the draft's token: echo it so no write or publish takes a draft
+// you have not seen.
+const draft = await client.writeDraft(created.method_id, {
+  mthds: "domain = 'demo'\n",
+  expected_updated_at: created.updated_at,
+});
+const published = await client.publishMethod(created.method_id, {
+  expected_draft_updated_at: draft.updated_at,
+});
+if (published.outcome === "refused") console.error(published.message, published.validation);
+else console.log(`version ${published.version.version}`); // "published" or "unchanged"
+const versions = await client.listMethodVersions(created.method_id); // newest first
+const { method_id, version } = parseMethodSelector("mt_abc123@3"); // the method routes take a bare id
+
 try {
   const { portal_url } = await client.getBillingPortal();
   // open portal_url ...

package/dist/cli/help.d.ts

@@ -1,4 +1,4 @@
 /** The command's help texts, printed on stdout by `--help`. */
-export declare const MAIN_HELP = "pipelex-sdk: run an MTHDS method on the Pipelex API, with nothing to install.\n\nUsage:\n  pipelex-sdk run --method <method> [--pipe <domain.pipe_code>] [--inputs <file> | --inputs-template]\n  pipelex-sdk script --method <address | catalog id> [--pipe <domain.pipe_code>] [--name <name>] [--dir <dir>]\n  pipelex-sdk --version\n  pipelex-sdk <command> --help\n\nCommands:\n  run      Run a method and print its main output as JSON on stdout.\n  script   Write a shell script that runs one method with this SDK's version pinned.\n\nA method is a published address, github.com/<owner>/<repo>[/<package>][@<tag>], a catalog\nid, mt_..., or, for run only, a .mthds file or a bundle directory.\n\nThe API key is read from PIPELEX_API_KEY, and the API's address from PIPELEX_BASE_URL\n(https://api.pipelex.com when unset). No .env file is read.\n\nExit codes: 0 done, 1 the run failed or the API refused it, 2 a usage error, 130 interrupted.\n";
-export declare const RUN_HELP = "Usage: pipelex-sdk run --method <method> [--pipe <domain.pipe_code>] [--inputs <file> | --inputs-template]\n\nRun a method on the Pipelex API, wait for it however long it takes, and print its main\noutput as indented JSON on stdout. The run id, each uploaded file and every error go to\nstderr. Ctrl-C stops waiting; the run keeps going on the server.\n\nOptions:\n  --method <method>          A published address (github.com/<owner>/<repo>[/<package>][@<tag>]),\n                             a catalog id (mt_...), or a path to a .mthds file or a bundle directory.\n  --pipe <domain.pipe_code>  The pipe to run, by its qualified ref. Default: the method's main pipe.\n  --inputs <file>            The inputs, a JSON object with one entry per input; - reads stdin.\n                             A local path or a data: URL at a file input is uploaded first.\n  --inputs-template          Print the inputs template, the object --inputs takes, and run nothing.\n  -h, --help                 Show this help.\n\nNeeds PIPELEX_API_KEY in the environment.\n";
-export declare const SCRIPT_HELP = "Usage: pipelex-sdk script --method <address | catalog id> [--pipe <domain.pipe_code>] [--name <name>] [--dir <dir>]\n\nCheck a method with the API, then write an executable shell script that runs it through\nthis SDK, its version pinned. The script passes its own arguments on to run:\n./<name> --inputs inputs.json, or ./<name> --inputs-template. It never overwrites a file.\n\nOptions:\n  --method <method>          A published address (github.com/<owner>/<repo>[/<package>][@<tag>])\n                             or a catalog id (mt_...). A local bundle is refused.\n  --pipe <domain.pipe_code>  The pipe the script runs. Default: the method's main pipe.\n  --name <name>              The script's file name. Default: the address's last segment, or the\n                             catalog method's name in kebab-case.\n  --dir <dir>                Where to write it. Default: the current directory.\n  -h, --help                 Show this help.\n\nNeeds PIPELEX_API_KEY in the environment. The script needs a POSIX shell.\n";
+export declare const MAIN_HELP = "pipelex-sdk: run an MTHDS method on the Pipelex API, with nothing to install.\n\nUsage:\n  pipelex-sdk run --method <method> [--pipe <domain.pipe_code>] [--inputs <file> | --inputs-template]\n  pipelex-sdk script --method <address | catalog id> [--pipe <domain.pipe_code>] [--name <name>] [--dir <dir>]\n  pipelex-sdk --version\n  pipelex-sdk <command> --help\n\nCommands:\n  run      Run a method and print its main output as JSON on stdout.\n  script   Write a shell script that runs one method with this SDK's version pinned.\n\nA method is a published address, github.com/<owner>/<repo>[/<package>][@<tag>], a catalog\nid, mt_..., or, for run only, a .mthds file or a bundle directory. A bare catalog id runs the\nmethod's latest published version, mt_...@<version> a fixed version, and mt_...@draft its draft.\n\nThe API key is read from PIPELEX_API_KEY, and the API's address from PIPELEX_BASE_URL\n(https://api.pipelex.com when unset). No .env file is read.\n\nExit codes: 0 done, 1 the run failed or the API refused it, 2 a usage error, 130 interrupted.\n";
+export declare const RUN_HELP = "Usage: pipelex-sdk run --method <method> [--pipe <domain.pipe_code>] [--inputs <file> | --inputs-template]\n\nRun a method on the Pipelex API, wait for it however long it takes, and print its main\noutput as indented JSON on stdout. The run id, each uploaded file and every error go to\nstderr. Ctrl-C stops waiting; the run keeps going on the server.\n\nOptions:\n  --method <method>          A published address (github.com/<owner>/<repo>[/<package>][@<tag>]),\n                             a catalog id (mt_..., mt_...@<version> or mt_...@draft), or a path\n                             to a .mthds file or a bundle directory.\n  --pipe <domain.pipe_code>  The pipe to run, by its qualified ref. Default: the method's main pipe.\n  --inputs <file>            The inputs, a JSON object with one entry per input; - reads stdin.\n                             A local path or a data: URL at a file input is uploaded first.\n  --inputs-template          Print the inputs template, the object --inputs takes, and run nothing.\n  -h, --help                 Show this help.\n\nNeeds PIPELEX_API_KEY in the environment.\n";
+export declare const SCRIPT_HELP = "Usage: pipelex-sdk script --method <address | catalog id> [--pipe <domain.pipe_code>] [--name <name>] [--dir <dir>]\n\nCheck a method with the API, then write an executable shell script that runs it through\nthis SDK, its version pinned. The script passes its own arguments on to run:\n./<name> --inputs inputs.json, or ./<name> --inputs-template. It never overwrites a file.\n\nOptions:\n  --method <method>          A published address (github.com/<owner>/<repo>[/<package>][@<tag>])\n                             or a catalog id (mt_..., mt_...@<version> or mt_...@draft). A local\n                             bundle is refused.\n  --pipe <domain.pipe_code>  The pipe the script runs. Default: the method's main pipe.\n  --name <name>              The script's file name. Default: the address's last segment, or the\n                             catalog method's name in kebab-case.\n  --dir <dir>                Where to write it. Default: the current directory.\n  -h, --help                 Show this help.\n\nNeeds PIPELEX_API_KEY in the environment. The script needs a POSIX shell.\n";

package/dist/cli/help.js

@@ -12,7 +12,8 @@ Commands:
   script   Write a shell script that runs one method with this SDK's version pinned.
 
 A method is a published address, github.com/<owner>/<repo>[/<package>][@<tag>], a catalog
-id, mt_..., or, for run only, a .mthds file or a bundle directory.
+id, mt_..., or, for run only, a .mthds file or a bundle directory. A bare catalog id runs the
+method's latest published version, mt_...@<version> a fixed version, and mt_...@draft its draft.
 
 The API key is read from PIPELEX_API_KEY, and the API's address from PIPELEX_BASE_URL
 (https://api.pipelex.com when unset). No .env file is read.
@@ -27,7 +28,8 @@ stderr. Ctrl-C stops waiting; the run keeps going on the server.
 
 Options:
   --method <method>          A published address (github.com/<owner>/<repo>[/<package>][@<tag>]),
-                             a catalog id (mt_...), or a path to a .mthds file or a bundle directory.
+                             a catalog id (mt_..., mt_...@<version> or mt_...@draft), or a path
+                             to a .mthds file or a bundle directory.
   --pipe <domain.pipe_code>  The pipe to run, by its qualified ref. Default: the method's main pipe.
   --inputs <file>            The inputs, a JSON object with one entry per input; - reads stdin.
                              A local path or a data: URL at a file input is uploaded first.
@@ -44,7 +46,8 @@ this SDK, its version pinned. The script passes its own arguments on to run:
 
 Options:
   --method <method>          A published address (github.com/<owner>/<repo>[/<package>][@<tag>])
-                             or a catalog id (mt_...). A local bundle is refused.
+                             or a catalog id (mt_..., mt_...@<version> or mt_...@draft). A local
+                             bundle is refused.
   --pipe <domain.pipe_code>  The pipe the script runs. Default: the method's main pipe.
   --name <name>              The script's file name. Default: the address's last segment, or the
                              catalog method's name in kebab-case.

package/dist/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;CAmBxB,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;CAgBvB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;CAgB1B,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;CAoBxB,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;CAiBvB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;CAiB1B,CAAC"}

package/dist/cli/method.d.ts

@@ -23,9 +23,15 @@ export type MethodSelector = {
  * happens to be named `mt_…` is reached as `./mt_…`, so that what a value names never depends on
  * what the current directory holds.
  *
- * @throws {CommandError} A usage error for an `mt_…` value holding a character no catalog id
- *   holds (a letter, a digit, `_` or `-`), such as `mt_review.mthds`, which is a path written
- *   without its `./`.
+ * A catalog id may carry a version suffix, `mt_…@<n>` for a fixed published version or
+ * `mt_…@draft` for the draft; it is kept whole, since the API resolves it.
+ *
+ * @throws {CommandError} A usage error for an `mt_…` value whose id holds a character no catalog
+ *   id holds (a letter, a digit, `_` or `-`), such as `mt_review.mthds`, which is a path written
+ *   without its `./`; and for a version suffix the selector grammar refuses, with the grammar's
+ *   own reason — a suffix that is neither a positive number without a leading zero nor `draft`,
+ *   or a number too large to address exactly. Both name the `./` form too, since an `mt_…`
+ *   value such as `mt_review@v2.mthds` may be a path written without it.
  */
 export declare function classifyMethod(value: string): MethodSelector;
 /**

package/dist/cli/method.js

@@ -2,27 +2,50 @@
  * How the command names a method and a pipe: the forms of `--method`, the qualified form of
  * `--pipe`, and the names and quoting `script` derives from them.
  */
+import { parseMethodSelector, RequestArgumentError } from "../index.js";
 import { usageError } from "./io.js";
 /** The prefix of a published method's address. */
 export const ADDRESS_PREFIX = "github.com/";
 /** The prefix of a stored method's catalog id. */
 export const CATALOG_ID_PREFIX = "mt_";
-/** The characters a catalog id is made of, which the API's run route accepts and no other. */
-const CATALOG_ID_SHAPE = /^[A-Za-z0-9_-]+$/;
+/** A catalog id without its version suffix: `mt_` and the characters the API's run route accepts. */
+const CATALOG_ID_SHAPE = /^mt_[A-Za-z0-9_-]+$/;
 /**
  * Tell a `--method` value's form by its shape: `mt_…` is a catalog id, `github.com/…` an address,
  * and anything else a path to a `.mthds` file or a bundle directory. A file or directory that
  * happens to be named `mt_…` is reached as `./mt_…`, so that what a value names never depends on
  * what the current directory holds.
  *
- * @throws {CommandError} A usage error for an `mt_…` value holding a character no catalog id
- *   holds (a letter, a digit, `_` or `-`), such as `mt_review.mthds`, which is a path written
- *   without its `./`.
+ * A catalog id may carry a version suffix, `mt_…@<n>` for a fixed published version or
+ * `mt_…@draft` for the draft; it is kept whole, since the API resolves it.
+ *
+ * @throws {CommandError} A usage error for an `mt_…` value whose id holds a character no catalog
+ *   id holds (a letter, a digit, `_` or `-`), such as `mt_review.mthds`, which is a path written
+ *   without its `./`; and for a version suffix the selector grammar refuses, with the grammar's
+ *   own reason — a suffix that is neither a positive number without a leading zero nor `draft`,
+ *   or a number too large to address exactly. Both name the `./` form too, since an `mt_…`
+ *   value such as `mt_review@v2.mthds` may be a path written without it.
  */
 export function classifyMethod(value) {
     if (value.startsWith(CATALOG_ID_PREFIX)) {
-        if (!CATALOG_ID_SHAPE.test(value)) {
-            throw usageError(`--method "${value}" is not a catalog id: a catalog id holds only letters, digits, _ and -.`, [`To name a local file or directory whose name starts with mt_, write it as ./${value}.`]);
+        const at = value.indexOf("@");
+        const bareId = at < 0 ? value : value.slice(0, at);
+        const pathHint = `To name a local file or directory whose name starts with mt_, write it as ./${value}.`;
+        if (!CATALOG_ID_SHAPE.test(bareId)) {
+            throw usageError(`--method "${value}" is not a catalog id: a catalog id holds only letters, digits, _ and -.`, [pathHint]);
+        }
+        // The id is well formed, so the selector grammar refuses the suffix alone, and its message
+        // says which way: a suffix of no known form, or a number too large to address exactly.
+        try {
+            parseMethodSelector(value);
+        }
+        catch (error) {
+            if (!(error instanceof RequestArgumentError))
+                throw error;
+            throw usageError(`--method ${error.message}`, [
+                `Pass ${bareId} for its latest published version, or ${bareId}@draft for its draft.`,
+                pathHint,
+            ]);
         }
         return { kind: "catalog", methodId: value };
     }

package/dist/cli/method.js.map

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

package/dist/cli/script.d.ts

@@ -10,8 +10,12 @@
  * one, with the permissions of an executable, an interrupt meanwhile waiting until it is whole.
  */
 import type { CommandIO } from "./io.js";
-/** The package a written script runs, and what its runner needs. */
-export declare const SCRIPT_RUNNER = "npx --yes @pipelex/sdk@0.34.0";
+/**
+ * The package a written script runs, and what its runner needs. The runner's flags keep npm's
+ * update notice and npm 12's run notices off the script's stderr, which carries the command's
+ * own lines, while npm's warnings and errors still print.
+ */
+export declare const SCRIPT_RUNNER = "npx --yes --no-update-notifier --loglevel=warn @pipelex/sdk@0.35.0";
 export declare const SCRIPT_WRITER = "@pipelex/sdk";
 export declare const SCRIPT_NEEDS = "Node 22.12 or later";
 /** Run `pipelex-sdk script` and return its exit code. */

package/dist/cli/script.js

@@ -11,7 +11,7 @@
  */
 import { lstat, open, stat, unlink } from "node:fs/promises";
 import { resolve } from "node:path";
-import { SDK_VERSION } from "../index.js";
+import { parseMethodSelector, SDK_VERSION } from "../index.js";
 import { parseFlags } from "./args.js";
 import { systemReason } from "./bundle.js";
 import { makeClient } from "./environment.js";
@@ -25,8 +25,12 @@ const SCRIPT_FLAGS = {
     name: { type: "string" },
     dir: { type: "string" },
 };
-/** The package a written script runs, and what its runner needs. */
-export const SCRIPT_RUNNER = `npx --yes @pipelex/sdk@${SDK_VERSION}`;
+/**
+ * The package a written script runs, and what its runner needs. The runner's flags keep npm's
+ * update notice and npm 12's run notices off the script's stderr, which carries the command's
+ * own lines, while npm's warnings and errors still print.
+ */
+export const SCRIPT_RUNNER = `npx --yes --no-update-notifier --loglevel=warn @pipelex/sdk@${SDK_VERSION}`;
 export const SCRIPT_WRITER = "@pipelex/sdk";
 export const SCRIPT_NEEDS = "Node 22.12 or later";
 /** Run `pipelex-sdk script` and return its exit code. */
@@ -174,11 +178,14 @@ function defaultName(candidate, method) {
     return candidate;
 }
 /**
- * A catalog method's name, kebab-cased, read from its catalog entry. An entry whose name is
- * missing or not a string gives an empty one, which asks for `--name` as an unusable name does.
+ * A catalog method's name, kebab-cased, read from its catalog entry. The name belongs to the
+ * method, not to a version, and the method route takes the bare id, so a version suffix is
+ * stripped for the read and kept in the script. An entry whose name is missing or not a
+ * string gives an empty one, which asks for `--name` as an unusable name does.
  */
 async function catalogName(client, methodId, io) {
-    const entry = await untilInterrupted(() => client.getMethod(methodId), io.interrupt);
+    const bareId = parseMethodSelector(methodId).method_id;
+    const entry = await untilInterrupted(() => client.getMethod(bareId), io.interrupt);
     const name = entry.name;
     return typeof name === "string" ? kebabCase(name) : "";
 }

package/dist/cli/script.js.map

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

package/dist/client.d.ts

@@ -1,7 +1,7 @@
 import type { MTHDSProtocol, ModelCategory, ModelDeck, RunOptions, StartOptions, VersionInfo } from "mthds/protocol";
-import type { CodegenRequest, CodegenResponse, DictPipeOutput, FormatResponse, LintResponse, MthdsFileItem, PipeIORequest, PipeIOResponse, PipelexRunResultStart, PipelexValidationResult, ResolveRequest, ResolveResponse, ValidateMethodSelector } from "./models.js";
+import type { CodegenRequest, CodegenResponse, DictPipeOutput, FormatResponse, LintResponse, ModelCheckCategory, ModelReferenceVerdict, MthdsFileItem, PipeIORequest, PipeIOResponse, PipelexRunResultStart, PipelexValidationResult, ResolveRequest, ResolveResponse, ValidateMethodSelector } from "./models.js";
 import { type GetRunResultOptions, type RunRead, type RunResults, type RunResultState, type StartAndWaitForResultOptions, type WaitForResultOptions } from "./runs.js";
-import type { BillingPortalResponse, ChangePlanResponse, CheckoutResponse, InvoiceView, Membership, MembershipsResponse, ListMethodsQuery, MethodData, MethodDeletionAccepted, MethodPage, MethodSummary, MethodWriteInput, OnboardingSubmission, PipelexApiKeyCreated, PipelexApiKeyList, ListRunsQuery, RunHistoryItem, RunDetail, RunPage, PlanView, ResolvedStorageUrl, SubscriptionResponse, UpdateRunInput, UploadGrant, UploadGrantInput, UploadInput, UploadedFile, UserProfile } from "./product-models.js";
+import type { BillingPortalResponse, ChangePlanResponse, CheckoutResponse, InvoiceView, Membership, MembershipsResponse, ListMethodsQuery, ListMethodVersionsQuery, MethodData, MethodDeletionAccepted, MethodDraftInput, MethodPage, MethodPublishInput, MethodPublishResult, MethodRenameInput, MethodSummary, MethodVersion, MethodVersionPage, MethodWriteInput, OnboardingSubmission, PipelexApiKeyCreated, PipelexApiKeyList, ListRunsQuery, RunHistoryItem, RunDetail, RunPage, PlanView, ResolvedStorageUrl, SubscriptionResponse, UpdateRunInput, UploadGrant, UploadGrantInput, UploadInput, UploadedFile, UserProfile } from "./product-models.js";
 import type { AppInfo } from "./user-agent.js";
 import type { UploadableAsset, UploadFileOptions, UploadRecord } from "./upload.js";
 import type { PrepareInputsRequest, PreparedInputs } from "./prepare-inputs.js";
@@ -175,20 +175,25 @@ export declare class PipelexApiClient implements MTHDSProtocol<DictPipeOutput> {
     private requestProductObject;
     /**
      * A methods-catalog route answering one stored method (`getMethod`, `createMethod`,
-     * `updateMethod`), parsed into the public shape. A stored `mthds` that is neither a string nor
-     * absent (`null` stays "no source", which `getMethodClosure` reports), and a stored `python`
-     * the SDK cannot parse, are an answer it cannot read, so each throws an `ApiResponseError` built
-     * from that answer, the latter with `mthds`'s refusal as `cause`: `runtime`, not retryable,
-     * since no change to the call fixes it.
+     * `writeDraft`, `renameMethod`), parsed into the public shape by `readStoredSources`.
      */
     private requestMethodData;
     /**
-     * One page of a cursor-paged product route (`listMethods`, `listRuns`), read as the platform
-     * always serializes it: `items` an array, `next_cursor` a string or `null`. A page breaking
-     * either is an answer the SDK cannot read, so it throws the `ApiResponseError` `unreadableAnswer`
-     * builds, `runtime` and not retryable, rather than handing the iterators a page they cannot
-     * walk: `items` that is not iterable, or a missing cursor that is neither the end nor a next
-     * page, which `iterateRuns` would follow forever.
+     * The stored sources of a method or of a published version, read from the answer `res`
+     * carried, into the public shape. A stored `mthds` that is neither a string nor absent (`null`
+     * stays "no source", which `getMethodClosure` reports), and a stored `python` the SDK cannot
+     * parse, are an answer it cannot read, so each throws an `ApiResponseError` built from that
+     * answer, the latter with `mthds`'s refusal as `cause`: `runtime`, not retryable, since no
+     * change to the call fixes it. `subject` names what carried them in the message.
+     */
+    private readStoredSources;
+    /**
+     * One page of a cursor-paged product route (`listMethods`, `listMethodVersions`, `listRuns`),
+     * read as the platform always serializes it: `items` an array, `next_cursor` a string or
+     * `null`. A page breaking either is an answer the SDK cannot read, so it throws the
+     * `ApiResponseError` `unreadableAnswer` builds, `runtime` and not retryable, rather than
+     * handing the iterators a page they cannot walk: `items` that is not iterable, or a missing
+     * cursor that is neither the end nor a next page, which `iterateRuns` would follow forever.
      */
     private requestPage;
     /** Issue a product request and return its 2xx answer, a non-2xx thrown as `ApiResponseError`. */
@@ -421,6 +426,26 @@ export declare class PipelexApiClient implements MTHDSProtocol<DictPipeOutput> {
     private requestExtension;
     /** The model deck the runner can route to — `GET /v1/models[?type=]`. */
     models(category?: ModelCategory): Promise<ModelDeck>;
+    /**
+     * Check one model reference — `GET /v1/models/check?reference=<ref>[&type=<category>]`, a
+     * Pipelex API extension served by any `pipelex-api` runner from pipelex 0.78.0 and on the
+     * hosted API.
+     *
+     * Answers whether `reference` resolves on the runner, as what kind and to which model, from
+     * the parser and the deck lookups a validation runs. `reference` is written as a method's
+     * `model` field writes it — `$preset`, `@alias`, `~waterfall`, a bare handle, or a
+     * spelled-out namespace (`handle:gpt-4o`) — and is sent percent-encoded. `category` checks
+     * in that category alone; without it, the check covers every one.
+     *
+     * Returns a **200 verdict** whatever the resolution: a reference that resolves nowhere is
+     * `resolution: "not_found"` with the names it may have meant, never a thrown error. Narrow
+     * on `kind` to read the shape of `matches`. A request that cannot produce a verdict throws
+     * the typed `ApiResponseError`, a `422` whose `errorType` says why: `InvalidModelReference`
+     * (a blank reference, a sigil or a namespace alone, or one past the runner's length limit),
+     * `InvalidModelCategory` (an unknown `type`) or `ValidationError`. None of that is checked
+     * here, so the runner's rule is the only one.
+     */
+    checkModelReference(reference: string, category?: ModelCheckCategory): Promise<ModelReferenceVerdict>;
     /**
      * Protocol + implementation versions — `GET /v1/version` (always public).
      * The handshake for feature detection (hosted extensions or not).
@@ -613,14 +638,29 @@ export declare class PipelexApiClient implements MTHDSProtocol<DictPipeOutput> {
      * explicit choice.
      */
     iterateMethods(query?: Omit<ListMethodsQuery, "cursor">): AsyncGenerator<MethodSummary, void, undefined>;
-    /** Fetch one method by id — `GET /v1/methods/{id}`. */
+    /**
+     * Read one method — `GET /v1/methods/{id}`: its identity, its draft (`mthds`, `python`,
+     * `input_data`) with the draft's token (`updated_at`) and digest (`draft_digest`), and its
+     * latest published version's summary (`latest_version`, `latest_published`), whatever the
+     * publish state. A method never published reads with both `null`, never as an error.
+     *
+     * Takes a bare catalog id: the method routes address the method itself, never a version of
+     * it. A caller holding `mt_…@3` strips the suffix with `parseMethodSelector` and reads that
+     * version with `getMethodVersion`. Every method route throws `RequestArgumentError` for a
+     * suffixed id, before any request, rather than read back the `404` the platform would answer.
+     */
     getMethod(methodId: string): Promise<MethodData>;
     /**
-     * Resolve a stored method's id into its runnable MTHDS closure — a client-side
-     * semantic layer over `getMethod` (the platform has no route that returns a
-     * parsed closure). Fetches the method, parses its polymorphic `mthds` source
-     * with `methodSourceToContents`, and labels each resulting file with the
-     * `method_id` as its `source` provenance.
+     * Resolve a stored method's id into the runnable MTHDS closure of its DRAFT — a
+     * client-side semantic layer over `getMethod` (the platform has no route that
+     * returns a parsed closure). Fetches the method, parses its draft's polymorphic
+     * `mthds` source with `methodSourceToContents`, and labels each resulting file
+     * with the `method_id` as its `source` provenance.
+     *
+     * **This is the draft, not what a bare id runs.** A run, a validation or a pipe I/O
+     * read by a bare `method_id` resolves to the latest PUBLISHED version, which the
+     * draft may be ahead of. For the closure of a version, read it with
+     * `getMethodVersion` and parse its `mthds` with `methodSourceToContents`.
      *
      * This is the LOCAL expansion utility — for callers that want the files in
      * hand (to edit, to diff, or to send to a bare runner, which has no catalog to
@@ -629,17 +669,104 @@ export declare class PipelexApiClient implements MTHDSProtocol<DictPipeOutput> {
      * `prepareInputs`, which composes a `pipeIo` of its own) take the id as a
      * pass-through instead; nothing in this client expands an id behind your back.
      *
-     * Requires an API key: the methods catalog is org-scoped to the key's org, so
-     * an unknown OR foreign-org id is a `getMethod` `404` (`ApiResponseError`
-     * `not_found`), which propagates unchanged. A real, in-org method whose source
-     * parses to nothing throws `EmptyMethodSourceError` (distinct from the 404) —
-     * the row exists but has no runnable source yet.
+     * Takes a bare catalog id, as `getMethod` does. Requires an API key: the methods
+     * catalog is org-scoped to the key's org, so an unknown OR foreign-org id is a
+     * `getMethod` `404` (`ApiResponseError` `not_found`), which propagates unchanged. A
+     * real, in-org method whose draft parses to nothing throws `EmptyMethodSourceError`
+     * (distinct from the 404) — the row exists but has no runnable source yet.
      */
     getMethodClosure(methodId: string): Promise<MthdsFileItem[]>;
-    /** Create a method — `POST /v1/methods`. */
+    /**
+     * Create a method — `POST /v1/methods`. The new method holds the input as its draft and has
+     * no published version, so its bare id answers `409 method_not_published` on the run and
+     * tooling routes until its first `publishMethod`; its draft runs as `mt_…@draft` at once.
+     */
     createMethod(input: MethodWriteInput): Promise<MethodData>;
-    /** Replace a method (rename = changed `name`) — `PUT /v1/methods/{id}`. */
-    updateMethod(methodId: string, input: MethodWriteInput): Promise<MethodData>;
+    /**
+     * Replace a method's draft — `PUT /v1/methods/{id}/draft` — and return the method with the
+     * draft's new token (`updated_at`) and digest (`draft_digest`).
+     *
+     * The draft is never validated on write, and writing it changes nothing for the callers of
+     * the method's bare id, who run the latest published version until the next `publishMethod`.
+     * `python` and `input_data` are three-way (see `MethodDraftInput`). With
+     * `expected_updated_at`, the write is a compare-and-swap on the draft token: a draft that
+     * moved since is refused with a `409` whose `code` is `method_update_conflict`, and nothing is
+     * written. Without it, last writer wins.
+     *
+     * Takes a bare catalog id, as `getMethod` does. Throws `ApiResponseError`: `404` `not_found`
+     * for an unknown or foreign-org method, `409` `method_being_deleted` while its erasure runs,
+     * `413` `payload_too_large` for a draft over the store's item limit, `403` for a read-only
+     * key.
+     */
+    writeDraft(methodId: string, input: MethodDraftInput): Promise<MethodData>;
+    /**
+     * Rename a method — `PATCH /v1/methods/{id}` — and return it. The name belongs to the method,
+     * not to a version: a rename changes nothing else, moves no token, and never commits the
+     * draft, so the `updated_at` a caller holds stays valid for its next `writeDraft` or
+     * `publishMethod`.
+     *
+     * Takes a bare catalog id, as `getMethod` does. Throws `ApiResponseError`: `404` `not_found`,
+     * `409` `method_being_deleted`, `403` for a read-only key, `422` for an empty name, and `413`
+     * `payload_too_large` for a name so long it would leave the method too large to publish.
+     */
+    renameMethod(methodId: string, input: MethodRenameInput): Promise<MethodData>;
+    /**
+     * Publish a method's draft as its next version — `POST /v1/methods/{id}/publish`.
+     *
+     * `expected_draft_updated_at` is the draft token the caller last saw, and it is required: a
+     * publish never takes a draft its caller has not seen. The platform checks the token, answers
+     * `unchanged` without asking the runner when the draft's digest equals the latest version's,
+     * and otherwise validates the draft and, when it validates and runs, writes version N+1.
+     *
+     * The answer is a `MethodPublishResult` discriminated on `outcome` — branch on it:
+     * `published` with the new `version`; `unchanged` with the existing latest `version`;
+     * `refused` with a `reason` (`invalid`, or `not_runnable` for a draft that validates with
+     * pending signatures), a `message` and the runner's `validation` verdict. Every arm carries the
+     * `method`. A publish moves no token.
+     *
+     * Takes a bare catalog id, as `getMethod` does. Throws `RequestArgumentError` when
+     * `expected_draft_updated_at` is not a string, before any request. Throws `ApiResponseError`
+     * when no verdict was produced: `409` `method_update_conflict` for a draft that moved since
+     * the token, `409` `method_being_deleted`, `404` `not_found`, `422` for a draft with no
+     * `.mthds` file or whose file names a run could not assemble (one name used by a `.mthds` and
+     * a Python file), `413` `payload_too_large` for a draft too large to publish, and `403` for a
+     * read-only key.
+     *
+     * Only a draft that differs from the latest version reaches the runner, and a runner that
+     * cannot be reached, answers unusably or does not finish within the platform's deadline is a
+     * `502` or a `503` with nothing written, so a retry is safe; a runner that refuses the request
+     * itself is relayed under its own status. A retry of a publish that landed while its answer was
+     * lost, as on a client timeout, answers `unchanged` with the version it wrote.
+     *
+     * An answer whose `outcome` is not one of the outcomes above, or that carries no `method`
+     * object, is an answer the SDK cannot read, thrown as an `ApiResponseError` too.
+     */
+    publishMethod(methodId: string, input: MethodPublishInput): Promise<MethodPublishResult>;
+    /**
+     * One page of a method's published versions, newest first, without their sources —
+     * `GET /v1/methods/{id}/versions`.
+     *
+     * Pass the page's `nextCursor` back as `cursor` to continue; `null` is the last page. A page
+     * may be short while `nextCursor` is set, because the platform reads versions whole. A method
+     * never published answers an empty page.
+     *
+     * Takes a bare catalog id, as `getMethod` does. Throws `ApiResponseError`: `404` `not_found`
+     * for an unknown method, `409` `method_being_deleted`, `400` for a cursor from another method.
+     * A page whose `items` is not an array or whose `next_cursor` is neither a string nor `null`
+     * is an answer the SDK cannot read, thrown as an `ApiResponseError` too.
+     */
+    listMethodVersions(methodId: string, query?: ListMethodVersionsQuery): Promise<MethodVersionPage>;
+    /**
+     * One published version of a method, with its sources —
+     * `GET /v1/methods/{id}/versions/{n}`. Its `python` is parsed into `MethodFile[]` as a
+     * method's is.
+     *
+     * Takes a bare catalog id, as `getMethod` does, and the version number. Throws
+     * `RequestArgumentError` for a `version` that is not a positive integer, before any request.
+     * Throws `ApiResponseError`: `404` `method_version_not_found` for a version the method never
+     * published, `404` `not_found` for an unknown method, `409` `method_being_deleted`.
+     */
+    getMethodVersion(methodId: string, version: number): Promise<MethodVersion>;
     /**
      * Erase a method and everything it produced — `DELETE /v1/methods/{id}`.
      *
@@ -653,8 +780,10 @@ export declare class PipelexApiClient implements MTHDSProtocol<DictPipeOutput> {
      * it with a `409`.
      *
      * A double-clicked delete is safe: the claim is a conditional write, so the
-     * second call is an `ApiResponseError` (`409 conflict`) rather than a second
-     * cascade over the same runs. An unknown or foreign-org id is a `404`.
+     * second call is an `ApiResponseError` (`409 method_being_deleted`) rather than a
+     * second cascade over the same runs. An unknown or foreign-org id is a `404`. The
+     * erasure deletes the method's published versions with the rest. Takes a bare catalog id,
+     * as `getMethod` does: the whole method is erased, never one of its versions.
      */
     deleteMethod(methodId: string): Promise<MethodDeletionAccepted>;
     /** The caller's org memberships + active-org feature flags — `GET /v1/organizations/memberships`. */
@@ -829,6 +958,12 @@ export declare class PipelexApiClient implements MTHDSProtocol<DictPipeOutput> {
      * `createdFrom` / `createdTo` are applied server-side as index key
      * conditions, so a bounded page genuinely reads less. They are INSTANTS,
      * not days — see `ListRunsQuery`.
+     *
+     * Takes a bare catalog id: the history files the runs of every version and
+     * of the draft together under it, so `mt_…@3` names no history of its own
+     * and the platform refuses it with a `400`. Strip a suffix with
+     * `parseMethodSelector`, and read which version a run ran from its
+     * `method_version`.
      */
     listRuns(methodId: string, query?: ListRunsQuery): Promise<RunPage>;
     /**
@@ -852,6 +987,8 @@ export declare class PipelexApiClient implements MTHDSProtocol<DictPipeOutput> {
      * cliff: it yields until the server says there is no more, the caller decides
      * when to stop, and only one page is ever in memory. If you truly want an
      * array, `Array.fromAsync` makes that your explicit choice.
+     *
+     * Takes a bare catalog id, as `listRuns` does.
      */
     iterateRuns(methodId: string, query?: Omit<ListRunsQuery, "cursor">): AsyncGenerator<RunHistoryItem, void, undefined>;
     /**