mthds 0.12.1 → 0.13.1

package/dist/runners/api/runs.js

@@ -1,93 +0,0 @@
-import { RunFailedError, RunTimeoutError } from "./exceptions.js";
-const TERMINAL_RUN_STATUSES = new Set([
-    "COMPLETED",
-    "FAILED",
-    "CANCELLED",
-    "TERMINATED",
-    "TIMED_OUT",
-]);
-/** A terminal status means the run is done and will not transition again. */
-export function isTerminalRunStatus(status) {
-    return TERMINAL_RUN_STATUSES.has(status);
-}
-/** Only `COMPLETED` has a result; every other terminal status is a failure. */
-export function isSuccessRunStatus(status) {
-    return status === "COMPLETED";
-}
-// ── Poll loop ───────────────────────────────────────────────────────
-export const DEFAULT_POLL_INTERVAL_MS = 2_000;
-export const DEFAULT_WAIT_TIMEOUT_MS = 1_200_000; // 20 min — matches the runner's blocking execute ceiling.
-/**
- * Poll a single-shot result lookup (`fetchOnce`) until the run reaches a
- * terminal state. Returns the artifacts on `COMPLETED`, throws `RunFailedError`
- * on any other terminal status, and throws `RunTimeoutError` if `timeoutMs`
- * elapses first (the run keeps executing server-side — re-poll by id later).
- *
- * The single owner of the wait/poll/Retry-After/abort logic. Both
- * `MthdsApiClient.waitForResult` and `BaseRunner.waitForResult` delegate here,
- * so the behavior can never drift between the wire client and the runner layer.
- */
-export async function pollUntilResult(fetchOnce, runId, options = {}) {
-    const intervalMs = options.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
-    const timeoutMs = options.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;
-    const startedAt = Date.now();
-    let attempt = 0;
-    for (;;) {
-        throwIfAborted(options.signal);
-        // Enforce the deadline BEFORE each lookup, so a poll is never issued past the
-        // timeout (the previous wait is clamped to the deadline, so the next loop
-        // would otherwise fire one extra fetch right at it).
-        const elapsedMs = Date.now() - startedAt;
-        if (elapsedMs >= timeoutMs) {
-            throw new RunTimeoutError(`Run ${runId} did not reach a terminal state within ${timeoutMs}ms.`, runId, timeoutMs);
-        }
-        const state = await fetchOnce(runId, { signal: options.signal });
-        if (state.state === "completed") {
-            return state.result;
-        }
-        if (state.state === "failed") {
-            throw new RunFailedError(state.message, runId, state.status);
-        }
-        attempt += 1;
-        options.onPoll?.({ attempt, elapsedMs });
-        const retryMs = state.retry_after_seconds != null ? state.retry_after_seconds * 1000 : 0;
-        const waitMs = Math.min(Math.max(intervalMs, retryMs), timeoutMs - elapsedMs);
-        await sleep(waitMs, options.signal);
-    }
-}
-function throwIfAborted(signal) {
-    if (signal?.aborted)
-        throw abortError(signal);
-}
-function abortError(signal) {
-    const reason = signal?.reason;
-    if (reason instanceof Error)
-        return reason;
-    return new DOMException("The run poll was aborted.", "AbortError");
-}
-/** Sleep that resolves after `ms`, or rejects immediately if `signal` aborts. */
-function sleep(ms, signal) {
-    if (ms <= 0) {
-        throwIfAborted(signal);
-        return Promise.resolve();
-    }
-    return new Promise((resolve, reject) => {
-        const onAbort = () => {
-            clearTimeout(timer);
-            reject(abortError(signal));
-        };
-        const timer = setTimeout(() => {
-            signal?.removeEventListener("abort", onAbort);
-            resolve();
-        }, ms);
-        if (signal) {
-            if (signal.aborted) {
-                clearTimeout(timer);
-                reject(abortError(signal));
-                return;
-            }
-            signal.addEventListener("abort", onAbort, { once: true });
-        }
-    });
-}
-//# sourceMappingURL=runs.js.map

package/dist/runners/api/runs.js.map

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

package/dist/runners/base-runner.d.ts

@@ -1,27 +0,0 @@
-import { type RunResults, type RunResultState, type WaitForResultOptions } from "./api/runs.js";
-import type { StartOptions } from "../protocol/options.js";
-import type { RunResultStart } from "../protocol/models.js";
-/**
- * Shared base for every runner. Provides the two run-lifecycle COMPOSITES —
- * `waitForResult` (poll an existing run to completion) and
- * `startAndWaitForResult` (start a run, then wait for its result) — implemented
- * once over the abstract primitives `start` / `getRunResult`. Concrete runners
- * implement the primitives; a runtime with a faster blocking path (a bare
- * runner, the local pipelex CLI) overrides `startAndWaitForResult`.
- *
- * The composites are deliberately NOT part of the `Runner` contract's "must
- * implement" surface — every runner gets them for free here, so they can never
- * drift between runtimes.
- */
-export declare abstract class BaseRunner {
-    /** Start a run and return its 202 ack immediately (no waiting; no output yet). The returned `pipeline_run_id` is authoritative. */
-    abstract start(options: StartOptions): Promise<RunResultStart>;
-    /** Single-shot result lookup: running (202) / completed (200) / failed (409). */
-    abstract getRunResult(runId: string, options?: {
-        signal?: AbortSignal;
-    }): Promise<RunResultState>;
-    /** Poll an already-started run (by id) until it reaches a terminal state. */
-    waitForResult(runId: string, options?: WaitForResultOptions): Promise<RunResults>;
-    /** Start a run, then wait for its result — the one-call convenience. */
-    startAndWaitForResult(options: StartOptions, pollOptions?: WaitForResultOptions): Promise<RunResults>;
-}

package/dist/runners/base-runner.js

@@ -1,25 +0,0 @@
-import { pollUntilResult, } from "./api/runs.js";
-/**
- * Shared base for every runner. Provides the two run-lifecycle COMPOSITES —
- * `waitForResult` (poll an existing run to completion) and
- * `startAndWaitForResult` (start a run, then wait for its result) — implemented
- * once over the abstract primitives `start` / `getRunResult`. Concrete runners
- * implement the primitives; a runtime with a faster blocking path (a bare
- * runner, the local pipelex CLI) overrides `startAndWaitForResult`.
- *
- * The composites are deliberately NOT part of the `Runner` contract's "must
- * implement" surface — every runner gets them for free here, so they can never
- * drift between runtimes.
- */
-export class BaseRunner {
-    /** Poll an already-started run (by id) until it reaches a terminal state. */
-    async waitForResult(runId, options) {
-        return pollUntilResult((id, opts) => this.getRunResult(id, opts), runId, options);
-    }
-    /** Start a run, then wait for its result — the one-call convenience. */
-    async startAndWaitForResult(options, pollOptions) {
-        const ack = await this.start(options);
-        return this.waitForResult(ack.pipeline_run_id, pollOptions);
-    }
-}
-//# sourceMappingURL=base-runner.js.map

package/dist/runners/base-runner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-runner.js","sourceRoot":"","sources":["../../src/runners/base-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAIhB,MAAM,eAAe,CAAC;AAIvB;;;;;;;;;;;GAWG;AACH,MAAM,OAAgB,UAAU;IAU9B,6EAA6E;IAC7E,KAAK,CAAC,aAAa,CACjB,KAAa,EACb,OAA8B;QAE9B,OAAO,eAAe,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,qBAAqB,CACzB,OAAqB,EACrB,WAAkC;QAElC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IAC9D,CAAC;CACF"}