@relayflows/sdk 2.0.0

package/dist/cli.js

@@ -0,0 +1,348 @@
+#!/usr/bin/env node
+import { realpathSync } from 'node:fs';
+import { pathToFileURL } from 'node:url';
+import { checkFlow, inputFailureReport, } from './cli/check.js';
+import { resumeFlow, runFlow, } from './cli/run.js';
+import { runDirectFlow } from './cli/direct-run.js';
+import { isAuthoredFlowPath } from './direct-input.js';
+import { runHnMonitor } from './cli/hn-monitor.js';
+import { runTickRunner } from './cli/tick-runner.js';
+const DEFAULT_DATA_DIR = '.relayflowd';
+const USAGE = [
+    'Usage:',
+    'flows check [--json] <flow.yaml|spec.json>',
+    'flows run [--json] [--data-dir <dir>] <flow.yaml|spec.json>',
+    'flows run [--json] [--data-dir <dir>] <flow.ts> --input <inline-json-or-file>',
+    'flows tick start --schedule-id <id> --interval-ms <ms> [--epoch-ms <ms>] [--max-catch-up <n>] [--poll-interval-ms <ms>] [--data-dir <dir>] <spec.json>',
+    'flows resume [--json] [--data-dir <dir>] <run-id>',
+    'flows hn-monitor start [--data-dir <dir>] [--poll-interval-ms <n>] <spec.json>',
+].join(' ');
+const PROCESS_IO = {
+    stdout: (line) => process.stdout.write(`${line}\n`),
+    stderr: (line) => process.stderr.write(`${line}\n`),
+};
+export async function runCli(args, io = PROCESS_IO) {
+    const parsed = parseArgs(args);
+    if (parsed === undefined) {
+        const report = inputFailureReport({ kind: 'invalid_invocation', message: USAGE });
+        emitCheckReport(report, args.includes('--json'), io);
+        return 2;
+    }
+    if (parsed.command === 'check') {
+        const checked = checkFlow(parsed.value);
+        emitCheckReport(checked.report, parsed.json, io);
+        return checked.report.ok ? 0 : 2;
+    }
+    if (parsed.command === 'hn-monitor') {
+        const controller = new AbortController();
+        const onSignal = () => controller.abort();
+        process.once('SIGINT', onSignal);
+        process.once('SIGTERM', onSignal);
+        try {
+            return await runHnMonitor({
+                dataDir: parsed.dataDir,
+                specPath: parsed.specPath,
+                pollIntervalMs: parsed.pollIntervalMs,
+                signal: controller.signal,
+            }, io);
+        }
+        finally {
+            process.off('SIGINT', onSignal);
+            process.off('SIGTERM', onSignal);
+        }
+    }
+    if (parsed.command === 'tick') {
+        const controller = new AbortController();
+        const onSignal = () => controller.abort();
+        process.once('SIGINT', onSignal);
+        process.once('SIGTERM', onSignal);
+        try {
+            return await runTickRunner({
+                dataDir: parsed.dataDir,
+                specPath: parsed.specPath,
+                schedule: {
+                    scheduleId: parsed.scheduleId,
+                    intervalMs: parsed.intervalMs,
+                    ...(parsed.epochMs === undefined ? {} : { epochMs: parsed.epochMs }),
+                    ...(parsed.maxCatchUp === undefined ? {} : { maxCatchUp: parsed.maxCatchUp }),
+                },
+                pollIntervalMs: parsed.pollIntervalMs,
+                signal: controller.signal,
+            }, io);
+        }
+        finally {
+            process.off('SIGINT', onSignal);
+            process.off('SIGTERM', onSignal);
+        }
+    }
+    const execution = parsed.command === 'run'
+        ? isAuthoredFlowPath(parsed.value)
+            ? await runDirectFlow(parsed.value, parsed.input, parsed.dataDir, { onWait: (progress) => emitWait(progress, io) })
+            : await runFlow(parsed.value, parsed.dataDir, { onWait: (progress) => emitWait(progress, io) })
+        : await resumeFlow(parsed.value, parsed.dataDir, { onWait: (progress) => emitWait(progress, io) });
+    emitRunReport(execution, parsed.json, io);
+    return execution.exitCode;
+}
+function emitWait(progress, io) {
+    io.stderr(`WAITING [worker_lease] Run "${progress.runId}" step "${progress.stepId}" (${progress.stepType}) `
+        + `is running under a worker lease until ${progress.leaseDeadlineMs}.`);
+}
+function parseArgs(args) {
+    const command = args[0];
+    if (command === 'hn-monitor')
+        return parseHnMonitorArgs(args.slice(1));
+    if (command === 'tick')
+        return parseTickArgs(args.slice(1));
+    if (command !== 'check' && command !== 'run' && command !== 'resume')
+        return undefined;
+    let json = false;
+    let dataDir = DEFAULT_DATA_DIR;
+    let sawDataDir = false;
+    let input;
+    let sawInput = false;
+    const positionals = [];
+    for (let index = 1; index < args.length; index += 1) {
+        const argument = args[index];
+        if (argument === '--json') {
+            if (json)
+                return undefined;
+            json = true;
+            continue;
+        }
+        if (argument === '--data-dir') {
+            const value = args[index + 1];
+            if (command === 'check' || sawDataDir || value === undefined || value.startsWith('-'))
+                return undefined;
+            dataDir = value;
+            sawDataDir = true;
+            index += 1;
+            continue;
+        }
+        if (argument === '--input') {
+            const value = args[index + 1];
+            if (command !== 'run' || sawInput || value === undefined || value.startsWith('--'))
+                return undefined;
+            input = value;
+            sawInput = true;
+            index += 1;
+            continue;
+        }
+        if (argument.startsWith('-'))
+            return undefined;
+        positionals.push(argument);
+    }
+    if (positionals.length !== 1)
+        return undefined;
+    if (command === 'run' && input !== undefined && !isAuthoredFlowPath(positionals[0]))
+        return undefined;
+    return command === 'check'
+        ? { command, json, value: positionals[0] }
+        : command === 'run'
+            ? { command, dataDir, input, json, value: positionals[0] }
+            : { command, dataDir, json, value: positionals[0] };
+}
+function parseHnMonitorArgs(rest) {
+    const sub = rest[0];
+    if (sub !== 'start')
+        return undefined;
+    let dataDir = DEFAULT_DATA_DIR;
+    let sawDataDir = false;
+    let pollIntervalMs;
+    const positionals = [];
+    for (let index = 1; index < rest.length; index += 1) {
+        const argument = rest[index];
+        if (argument === '--data-dir') {
+            const value = rest[index + 1];
+            if (sawDataDir || value === undefined || value.startsWith('-'))
+                return undefined;
+            dataDir = value;
+            sawDataDir = true;
+            index += 1;
+            continue;
+        }
+        if (argument === '--poll-interval-ms') {
+            const value = rest[index + 1];
+            if (pollIntervalMs !== undefined || value === undefined || value.startsWith('-'))
+                return undefined;
+            const parsed = Number.parseInt(value, 10);
+            if (!Number.isFinite(parsed) || parsed <= 0)
+                return undefined;
+            pollIntervalMs = parsed;
+            index += 1;
+            continue;
+        }
+        if (argument.startsWith('-'))
+            return undefined;
+        positionals.push(argument);
+    }
+    if (positionals.length !== 1)
+        return undefined;
+    return { command: 'hn-monitor', sub: 'start', dataDir, specPath: positionals[0], pollIntervalMs };
+}
+/**
+ * `flows tick start`. Numeric flags are parsed here but their BOUNDS are not
+ * re-derived: `runTickRunner` calls `assertTickScheduleValid`, the same
+ * function `emitDueTicks` uses, so the CLI's refusal and the emit path's
+ * refusal cannot drift. This parser only rejects shapes it cannot turn into a
+ * number at all.
+ */
+function parseTickArgs(rest) {
+    const sub = rest[0];
+    if (sub !== 'start')
+        return undefined;
+    let dataDir = DEFAULT_DATA_DIR;
+    let sawDataDir = false;
+    let scheduleId;
+    let intervalMs;
+    let epochMs;
+    let maxCatchUp;
+    let pollIntervalMs;
+    const positionals = [];
+    // Number, not parseInt: parseInt('1.5') is 1, so a fractional --interval-ms
+    // would silently become a 1ms schedule instead of being refused. Requiring
+    // an exact integer round-trip rejects '1.5', '1e3', '0x10' and ' 1' rather
+    // than coercing them into something the operator did not write.
+    const takeNumber = (value) => {
+        if (value === undefined || value.startsWith('-'))
+            return undefined;
+        const parsed = Number(value);
+        if (!Number.isInteger(parsed) || String(parsed) !== value)
+            return undefined;
+        return parsed;
+    };
+    for (let index = 1; index < rest.length; index += 1) {
+        const argument = rest[index];
+        if (argument === '--data-dir') {
+            const value = rest[index + 1];
+            if (sawDataDir || value === undefined || value.startsWith('-'))
+                return undefined;
+            dataDir = value;
+            sawDataDir = true;
+            index += 1;
+            continue;
+        }
+        if (argument === '--schedule-id') {
+            const value = rest[index + 1];
+            if (scheduleId !== undefined || value === undefined || value.startsWith('-'))
+                return undefined;
+            scheduleId = value;
+            index += 1;
+            continue;
+        }
+        if (argument === '--interval-ms') {
+            if (intervalMs !== undefined)
+                return undefined;
+            const value = takeNumber(rest[index + 1]);
+            if (value === undefined)
+                return undefined;
+            intervalMs = value;
+            index += 1;
+            continue;
+        }
+        if (argument === '--epoch-ms') {
+            if (epochMs !== undefined)
+                return undefined;
+            const value = takeNumber(rest[index + 1]);
+            if (value === undefined)
+                return undefined;
+            epochMs = value;
+            index += 1;
+            continue;
+        }
+        if (argument === '--max-catch-up') {
+            if (maxCatchUp !== undefined)
+                return undefined;
+            const value = takeNumber(rest[index + 1]);
+            if (value === undefined)
+                return undefined;
+            maxCatchUp = value;
+            index += 1;
+            continue;
+        }
+        if (argument === '--poll-interval-ms') {
+            if (pollIntervalMs !== undefined)
+                return undefined;
+            const value = takeNumber(rest[index + 1]);
+            if (value === undefined)
+                return undefined;
+            pollIntervalMs = value;
+            index += 1;
+            continue;
+        }
+        if (argument.startsWith('-'))
+            return undefined;
+        positionals.push(argument);
+    }
+    if (positionals.length !== 1 || scheduleId === undefined || intervalMs === undefined)
+        return undefined;
+    return {
+        command: 'tick', sub: 'start', dataDir, specPath: positionals[0],
+        scheduleId, intervalMs, epochMs, maxCatchUp, pollIntervalMs,
+    };
+}
+function emitCheckReport(report, json, io) {
+    emitDiagnostics(report.diagnostics, io);
+    if (json) {
+        io.stdout(JSON.stringify(report));
+        return;
+    }
+    for (const gate of report.gates) {
+        // A gate that accepts every output is legal, but it must not read like a
+        // gate that judges something.
+        const vacuous = gate.acceptsAnyOutput === true ? ' [json_schema accepts any output]' : '';
+        io.stdout(`GATE step "${gate.stepId}" ${gate.checks.join('+')} from data (kernel, journal-replayable)${vacuous}`);
+    }
+    for (const resolution of report.resolutions) {
+        const config = resolution.source === 'project' && report.projectConfigPath !== undefined
+            ? ` (${report.projectConfigPath})`
+            : '';
+        const model = resolution.model === undefined ? '' : ` model "${resolution.model}"`;
+        io.stdout(`RESOLVED step "${resolution.stepId}" cli "${resolution.cli}"${model} from ${resolution.source}${config}`);
+    }
+    if (report.ok)
+        io.stdout(`CHECK PASSED ${report.path ?? ''}`.trimEnd());
+}
+function emitRunReport(execution, json, io) {
+    const { report } = execution;
+    emitDiagnostics(report.diagnostics, io);
+    if (json) {
+        io.stdout(JSON.stringify(report));
+        return;
+    }
+    if (report.runId === undefined)
+        return;
+    const completed = report.completedSteps === undefined ? '' : ` (${report.completedSteps} steps)`;
+    const reason = report.completionReason === undefined
+        ? ''
+        : ` completionReason: ${report.completionReason}`;
+    io.stdout(`RUN ${report.runId} ${report.status ?? 'unknown'}${completed}${reason}`);
+}
+function emitDiagnostics(diagnostics, io) {
+    for (const diagnostic of diagnostics) {
+        io.stderr(`${diagnosticLabel(diagnostic.severity)} [${diagnostic.kind}] ${diagnostic.message}`);
+    }
+}
+function diagnosticLabel(severity) {
+    switch (severity) {
+        case 'warning': return 'WARNING';
+        case 'failure': return 'FAILED';
+        case 'parked': return 'PARKED';
+        default: return 'REFUSED';
+    }
+}
+function isDirectInvocation(entryPath) {
+    if (entryPath === undefined)
+        return false;
+    try {
+        return pathToFileURL(realpathSync(entryPath)).href === import.meta.url;
+    }
+    catch {
+        return false;
+    }
+}
+if (isDirectInvocation(process.argv[1])) {
+    void runCli(process.argv.slice(2)).then((exitCode) => {
+        process.exitCode = exitCode;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/compile.d.ts

@@ -0,0 +1,42 @@
+import type { FlowSpec, KernelRunSpec } from './spec.js';
+import { SPEC_SCHEMA_VERSION } from './spec.js';
+import { canonicalize, specHash } from './canonical.js';
+export declare class CompileError extends Error {
+    readonly errors: string[];
+    constructor(errors: string[]);
+}
+/**
+ * Compile a YAML string into a validated authoring `FlowSpec`.
+ * Throws `CompileError` on a YAML parse error or any validation failure.
+ */
+export declare function compileYaml(yaml: string): FlowSpec;
+/** Kernel-dialect canonical JSON of `compileYaml` (sorted keys, no whitespace). */
+export declare function compileYamlToCanonicalJson(yaml: string): string;
+/**
+ * Validate a parsed spec object and apply authoring defaults, returning a
+ * normalized `FlowSpec`. Throws `CompileError` on validation failure.
+ */
+export declare function compileSpec(spec: unknown): FlowSpec;
+/**
+ * Map an authoring `FlowSpec` to the kernel spec dialect — the single shape at
+ * the SDK↔kernel boundary (`kernel/relayflowd-core/src/spec.rs`). Authoring
+ * sugar that the dialect cannot carry is a `CompileError`, never a silent drop.
+ */
+export declare function toKernelSpec(flow: FlowSpec): KernelRunSpec;
+/**
+ * Map the kernel boundary dialect back to the normalized authoring shape.
+ * This is the inverse of `toKernelSpec` over specs this compiler emits.
+ * Kernel-only values with no authoring representation are refused.
+ */
+export declare function kernelToAuthoring(value: unknown): unknown;
+/**
+ * Compile + hash in one call. `hash` is sha256 of the kernel-dialect canonical
+ * JSON — the spec identity the kernel stamps as `spec_hash` in `run.spawned`.
+ */
+export declare function compileAndHash(yaml: string): {
+    spec: FlowSpec;
+    kernelSpec: KernelRunSpec;
+    hash: string;
+};
+export { SPEC_SCHEMA_VERSION, canonicalize, specHash };
+//# sourceMappingURL=compile.d.ts.map

package/dist/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAGV,QAAQ,EAER,aAAa,EAYd,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAKxD,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBACd,MAAM,EAAE,MAAM,EAAE;CAK7B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAMlD;AAED,mFAAmF;AACnF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CA8BnD;AA8HD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,aAAa,CA+B1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA8BzD;AAsQD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAIxG;AAED,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC"}