@relayflows/sdk 2.0.30 → 2.0.31

package/dist/cli/cloud-live.js

@@ -0,0 +1,325 @@
+// `flows status --cloud --watch` and `flows logs <run> --follow`: the two
+// hosted reads that keep reading.
+//
+// The one-shot verbs (cli/cloud-read.ts) answer "what did that run do". These
+// two answer "what is it doing", by asking again until the run is over. Three
+// properties separate them from a loop around the one-shot reads:
+//
+//  1. **The exit code is the run's.** A finished page is not evidence that the
+//     run succeeded; `getCloudRunDetailLive` validates the same record
+//     `flows run --wait` blocks on, so `--watch` and `--follow` exit 0 only on
+//     an attested `completed`/`success`, 1 on an attested failure or a
+//     cancellation, and refuse a terminal record that attests neither.
+//  2. **A frame is whole or absent.** The page is rendered, then the abort is
+//     checked, then the whole page leaves in one `io.stdout` call. A Ctrl-C
+//     mid-poll ends the command with a refusal and no half-drawn screen.
+//  3. **Nothing is invented while waiting.** A failed poll leaves the previous
+//     page and the consumed log exactly where they were; it never clears the
+//     screen to show an error, and never re-prints a line it has shown.
+//
+// Cancellation is the caller's: `runCli` hands these functions the signal it
+// owns for the verb's duration, and nothing here installs a process handler.
+// Aborting stops the observation, not the hosted run — the refusal says so.
+import { canonicalize } from '../canonical.js';
+import { getCloudRunDetailLive, getCloudRunLog, getCloudRunSteps, } from '../cloud-read.js';
+import { isCloudRunActive } from '../cloud-run-record.js';
+import { endsWithOpenCredentialHeader, openCredentialStart, openSecretStart, redact } from '../redact.js';
+import { thousands } from './cloud-format.js';
+import { fail, isTransientRead, refusalFor, RUN_ID_REQUIRED } from './cloud-refusal.js';
+import { renderCloudStatus, scrubRun, scrubSteps } from './cloud-status-view.js';
+import { sleepInterruptible } from './interruptible-sleep.js';
+/** The cadence `waitForCloudFlowRun` polls at; not a user flag on either verb. */
+const DEFAULT_POLL_INTERVAL_MS = 2_000;
+const MAX_BACKOFF_MS = 30_000;
+/** Clears the screen only for a terminal; a redirected page must stay text. */
+function clearSequence(io) {
+    return io.tty === true ? '\u001b[2J\u001b[H' : '';
+}
+/** The same delay schedule as `waitForCloudFlowRun`: ×2 per failure, capped. */
+function delayFor(failures, interval) {
+    return failures === 0 ? interval : Math.min(interval * 2 ** (failures - 1), MAX_BACKOFF_MS);
+}
+/** The hosted `flows run --wait` mapping: only an attested success is 0. */
+function exitFor(state) {
+    return state.status === 'completed' ? 0 : 1;
+}
+function aborted(verb, runId, json, io) {
+    fail({
+        code: 'observation_aborted', exit: 1,
+        message: `Stopped ${verb} run ${runId}; the hosted run has not been cancelled.`,
+    }, json, io);
+    return 1;
+}
+/**
+ * Has the caller cancelled?
+ *
+ * A function rather than `signal?.aborted` at each site on purpose: `aborted`
+ * is a readonly property, so an inline check narrows the signal's type for the
+ * rest of the block and the compiler then calls every later check dead — which
+ * is exactly backwards for a value that changes under an await.
+ */
+function isAborted(signal) {
+    return signal !== undefined && signal.aborted;
+}
+function invalidInterval(interval) {
+    return !Number.isSafeInteger(interval) || interval < 1 || interval > 60_000;
+}
+// -------------------------------------------------- flows status --cloud --watch
+/**
+ * Redraw the hosted status page until the run is terminal, then leave the
+ * final page up and exit with the run's outcome.
+ *
+ * The detail and the step rows are two requests against two projections, so
+ * the page is a pair of reads and not an atomic snapshot: a step row can lag
+ * the header it is drawn under by one poll. That is a property of the API, and
+ * this view reports what each read said rather than reconciling them.
+ */
+export async function runCloudStatusWatch(args, io, options = {}) {
+    const env = options.env ?? process.env;
+    const clock = options.now ?? Date.now;
+    const signal = options.signal;
+    const interval = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const sleep = options.sleep ?? sleepInterruptible;
+    if (args.runId === undefined || args.runId.length === 0)
+        return fail(RUN_ID_REQUIRED, args.json, io);
+    const runId = args.runId;
+    if (invalidInterval(interval)) {
+        return fail({ code: 'cloud_configuration', exit: 2, message: 'pollIntervalMs must be an integer from 1 to 60000.' }, args.json, io);
+    }
+    let failures = 0;
+    for (;;) {
+        if (isAborted(signal))
+            return aborted('watching', runId, args.json, io);
+        let live;
+        let steps;
+        try {
+            live = await getCloudRunDetailLive(runId, options);
+            if (isAborted(signal))
+                return aborted('watching', runId, args.json, io);
+            steps = await getCloudRunSteps(runId, options);
+        }
+        catch (error) {
+            if (isAborted(signal))
+                return aborted('watching', runId, args.json, io);
+            if (!isTransientRead(error))
+                return fail(refusalFor(error, `run ${runId}`, env), args.json, io);
+            // The previous page stays exactly as it was: a poll that did not
+            // complete is not news about the run.
+            failures = Math.min(failures + 1, 16);
+            await sleep(delayFor(failures, interval), signal);
+            continue;
+        }
+        failures = 0;
+        const run = scrubRun(live.detail, env);
+        const scrubbed = scrubSteps(steps, env);
+        const terminal = !isCloudRunActive(live.state.status);
+        // Rendered before the abort check and emitted after it, in one call: an
+        // interrupt between two lines of a frame would leave a torn page.
+        const page = args.json ? '' : `${clearSequence(io)}${renderCloudStatus(run, scrubbed, clock()).join('\n')}`;
+        if (isAborted(signal))
+            return aborted('watching', runId, args.json, io);
+        if (!args.json)
+            io.stdout(page);
+        if (terminal) {
+            if (args.json)
+                io.stdout(canonicalize({ v: 1, ok: true, run, steps: scrubbed, now_ms: clock() }));
+            return exitFor(live.state);
+        }
+        await sleep(interval, signal);
+    }
+}
+/**
+ * Print `text` as lines.
+ *
+ * Splitting is on `\n` only, and one trailing `\r` per line is dropped: a
+ * CRLF log printed with its carriage returns intact makes a terminal overwrite
+ * each line it just drew. A final newline ends the last line rather than
+ * starting an empty one. Blank lines and repeated identical lines are
+ * preserved — they are the log.
+ */
+function writeLines(text, state, io) {
+    const lines = text.split('\n');
+    if (lines.at(-1) === '')
+        lines.pop();
+    for (const line of lines) {
+        io.stdout(line.replace(/\r$/u, ''));
+        state.emitted = true;
+    }
+}
+/** The last line boundary at or before `at`: 0, or the index after a newline. */
+function lineBoundaryAtOrBefore(text, at) {
+    return at <= 0 ? 0 : text.lastIndexOf('\n', at - 1) + 1;
+}
+/**
+ * Release every line the log has settled on, redacted as one block.
+ *
+ * Four things hold a line back. `openSecretStart` marks where a secret value
+ * has begun and not ended, so nothing at or past it can be shown until the
+ * next poll completes it. `openCredentialStart` marks a trailing credential
+ * header — `authorization:`, `Bearer`, a callback-token name, or an
+ * unterminated credential JSON field — whose value may only arrive on a later
+ * poll; releasing the header first would leave the value without the context
+ * the redactor needs. A block is never ended on a bare credential header even
+ * when more text follows, because the redactor folds the header's newline
+ * into its own match — the block-prefix check cannot see that the header's
+ * value lives on the next line. And a candidate block is released only when
+ * redacting it alone gives the same text as the front of the whole redacted
+ * remainder: if the cut fell inside something the redactor would have caught —
+ * the second line of a private key — the two disagree, and the cut moves back
+ * a line and is tried again.
+ *
+ * A poll that can release nothing prints nothing; the bytes are not lost, they
+ * are held until a later poll or the drain flush can redact them whole.
+ */
+function releaseLines(state, io, env) {
+    const raw = state.consumed;
+    if (state.released >= raw.length)
+        return;
+    const remainder = redact(raw.slice(state.released), env);
+    let cut = lineBoundaryAtOrBefore(raw, Math.min(openSecretStart(raw, env), openCredentialStart(raw)));
+    while (cut > state.released) {
+        if (endsWithOpenCredentialHeader(raw.slice(state.released, cut))) {
+            // A bare credential header as the released block's last line strands
+            // the value that starts on the next line — redact needs them together.
+            // Shrink until the header is inside the held remainder; it releases
+            // with its value line once that line is complete.
+            cut = lineBoundaryAtOrBefore(raw, cut - 1);
+            continue;
+        }
+        const block = redact(raw.slice(state.released, cut), env);
+        if (remainder.startsWith(block)) {
+            writeLines(block, state, io);
+            state.released = cut;
+            return;
+        }
+        cut = lineBoundaryAtOrBefore(raw, cut - 1);
+    }
+}
+/**
+ * Has Cloud finished publishing this log?
+ *
+ * Three facts, all required. The run being over does not mean the last bytes
+ * have been written; `done` alone does not mean the run is over (the route can
+ * report a completed *upload* of a log the run is still adding to); and a
+ * `done` envelope that carries fewer bytes than it advertises has not served
+ * the tail. Stopping on any one of them alone would truncate the output, which
+ * is the one thing a follow must not do.
+ */
+function logDrained(log, terminal, content) {
+    return terminal && log.done && Buffer.byteLength(content, 'utf8') >= log.total_size;
+}
+/**
+ * Append the hosted runner log until the run is terminal and its log is drained.
+ *
+ * The route serves the log from an offset, but this client does not page it:
+ * the offsets are byte counts and the content is a JavaScript string, and
+ * subtracting one from the other silently loses text the moment a log contains
+ * a non-ASCII character — which the runner's own transition lines do. Until
+ * the byte-range contract can be checked against the server, each poll reads
+ * the whole log and prints the part that is new, refusing outright if what it
+ * already showed is no longer a prefix of what Cloud serves. That costs a full
+ * read per poll and holds the log in memory; it cannot duplicate or drop a line.
+ */
+export async function runCloudLogsFollow(args, io, options = {}) {
+    const env = options.env ?? process.env;
+    const signal = options.signal;
+    const interval = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const sleep = options.sleep ?? sleepInterruptible;
+    const runId = args.runId;
+    // Refused before any request: a step transcript is not an append-only stream
+    // this verb can follow. A retry replaces it, and the rendered form is built
+    // from the whole JSONL — attempt markers, session header, result footer —
+    // rather than a line at a time.
+    if (args.step !== undefined) {
+        return fail({
+            code: 'invalid_invocation', exit: 2,
+            message: '`flows logs --follow` follows the runner log, which is append-only; it cannot follow a step '
+                + 'transcript. Follow the run with `flows logs <run-id> --follow`, or read the step transcript once '
+                + 'with `flows logs <run-id> --step <name>`.',
+        }, args.json, io);
+    }
+    if (invalidInterval(interval)) {
+        return fail({ code: 'cloud_configuration', exit: 2, message: 'pollIntervalMs must be an integer from 1 to 60000.' }, args.json, io);
+    }
+    const state = { consumed: '', released: 0, emitted: false };
+    let header = false;
+    let failures = 0;
+    // A snapshot that satisfies every drain fact can still predate terminality:
+    // `done` can describe an upload finished while the run kept writing, and the
+    // log route can keep serving that snapshot past the terminal transition.
+    // The read that ends the follow has to postdate the terminal observation —
+    // which on the first sighting it cannot — so a terminal run always gets one
+    // more poll before its log counts as drained.
+    let terminalObserved = false;
+    for (;;) {
+        if (isAborted(signal))
+            return aborted('following', runId, args.json, io);
+        let outcome;
+        let log;
+        try {
+            // The run record first: a log read that follows a terminal status can
+            // only be missing bytes Cloud had not published yet, never bytes written
+            // after the check.
+            const live = await getCloudRunDetailLive(runId, options);
+            if (isAborted(signal))
+                return aborted('following', runId, args.json, io);
+            log = await getCloudRunLog(runId, undefined, options);
+            outcome = live.state;
+        }
+        catch (error) {
+            if (isAborted(signal))
+                return aborted('following', runId, args.json, io);
+            if (!isTransientRead(error))
+                return fail(refusalFor(error, `run ${runId}`, env), args.json, io);
+            failures = Math.min(failures + 1, 16);
+            await sleep(delayFor(failures, interval), signal);
+            continue;
+        }
+        failures = 0;
+        if (isAborted(signal))
+            return aborted('following', runId, args.json, io);
+        if (!log.content.startsWith(state.consumed)) {
+            return fail({
+                code: 'cloud_log_rewritten', exit: 1,
+                message: `Cloud's runner log for run ${runId} no longer begins with the ${thousands(state.consumed.length)} `
+                    + 'characters already shown, so following it would skip or repeat output. Read it whole with '
+                    + `\`flows logs ${runId}\`.`,
+            }, args.json, io);
+        }
+        state.consumed = log.content;
+        const terminal = !isCloudRunActive(outcome.status);
+        const drained = terminalObserved && logDrained(log, terminal, log.content);
+        terminalObserved ||= terminal;
+        if (!args.json) {
+            if (!header) {
+                io.stdout(`LOG ${runId}  runner  following  ${thousands(log.total_size)} bytes so far`);
+                header = true;
+            }
+            releaseLines(state, io, env);
+        }
+        if (!drained) {
+            await sleep(interval, signal);
+            continue;
+        }
+        // Drained: the last line may have no newline, and this is the only moment
+        // at which printing it cannot cut a line in half.
+        if (args.json) {
+            io.stdout(canonicalize({
+                v: 1, ok: true, run_id: runId, step: null,
+                bytes: log.offset, total_bytes: log.total_size, done: log.done,
+                content: redact(log.content, env),
+            }));
+            return exitFor(outcome);
+        }
+        if (state.released < state.consumed.length) {
+            writeLines(redact(state.consumed.slice(state.released), env), state, io);
+            state.released = state.consumed.length;
+        }
+        if (!state.emitted)
+            io.stdout('  (empty)');
+        io.stdout(`${outcome.status.toUpperCase()} ${runId} completionReason: `
+            + `${'completionReason' in outcome ? outcome.completionReason : 'unavailable'}`);
+        return exitFor(outcome);
+    }
+}
+//# sourceMappingURL=cloud-live.js.map

package/dist/cli/cloud-live.js.map

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

package/dist/cli/cloud-read.d.ts

@@ -1,4 +1,4 @@
-import { type CloudConnectionOptions } from '../cloud-http.js';
+import { type CloudReadOptions } from './cloud-refusal.js';
 import type { CliIo } from '../cli.js';
 export interface RunsArgs {
     command: 'runs';
@@ -11,17 +11,13 @@ export interface LogsArgs {
     step: string | undefined;
     raw: boolean;
     json: boolean;
+    /** `--follow`: append new runner output until the run is terminal (cli/cloud-live.ts). */
+    follow: boolean;
 }
 /** Enough runs to recognise the one you mean; `--limit` raises it. */
 export declare const DEFAULT_RUN_LIMIT = 20;
-/** Injected by tests; production takes the ambient clock and environment. */
-export interface CloudReadOptions extends CloudConnectionOptions {
-    env?: NodeJS.ProcessEnv;
-    now?: () => number;
-}
 export declare function parseRunsArgs(args: readonly string[]): RunsArgs | undefined;
 export declare function parseLogsArgs(args: readonly string[]): LogsArgs | undefined;
-export declare function errorLines(text: string, indent: string): string[];
 export declare function runCloudRunsCli(args: RunsArgs, io: CliIo, options?: CloudReadOptions): Promise<0 | 1 | 2>;
 export declare function runCloudLogsCli(args: LogsArgs, io: CliIo, options?: CloudReadOptions): Promise<0 | 1 | 2>;
 export declare function runCloudStatusCli(args: {

package/dist/cli/cloud-read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-read.d.ts","sourceRoot":"","sources":["../../src/cli/cloud-read.ts"],"names":[],"mappings":"AAeA,OAAO,EAAkB,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAQ/E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,6EAA6E;AAC7E,MAAM,WAAW,gBAAiB,SAAQ,sBAAsB;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,GAAG,SAAS,CAiB3E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,GAAG,SAAS,CAyB3E;AAsGD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBjE;AAiBD,wBAAsB,eAAe,CACnC,IAAI,EAAE,QAAQ,EACd,EAAE,EAAE,KAAK,EACT,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAyCpB;AAID,wBAAsB,eAAe,CACnC,IAAI,EAAE,QAAQ,EACd,EAAE,EAAE,KAAK,EACT,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAsEpB;AA+GD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,EACvC,EAAE,EAAE,KAAK,EACT,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CA2CpB"}
+{"version":3,"file":"cloud-read.d.ts","sourceRoot":"","sources":["../../src/cli/cloud-read.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAqC,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE9F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,0FAA0F;IAC1F,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,GAAG,SAAS,CAiB3E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,GAAG,SAAS,CA6B3E;AAID,wBAAsB,eAAe,CACnC,IAAI,EAAE,QAAQ,EACd,EAAE,EAAE,KAAK,EACT,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAyCpB;AAID,wBAAsB,eAAe,CACnC,IAAI,EAAE,QAAQ,EACd,EAAE,EAAE,KAAK,EACT,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAsEpB;AAID,wBAAsB,iBAAiB,CACrC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,EACvC,EAAE,EAAE,KAAK,EACT,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAoBpB"}