@tagma/sdk 0.4.2 → 0.4.4

package/dist/runner.js

@@ -0,0 +1,364 @@
+import { existsSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { shellArgs } from './utils';
+// Delay before escalating SIGTERM to SIGKILL when killing a timed-out process.
+const SIGKILL_DELAY_MS = 3_000;
+/**
+ * On Windows, proc.kill('SIGTERM') / proc.kill('SIGKILL') only terminate the
+ * direct child process. When the child is a .cmd/.bat wrapper (e.g. claude.cmd),
+ * cmd.exe spawns the real process as a grandchild — proc.kill misses it entirely.
+ * `taskkill /F /T /PID` kills the entire process tree rooted at the given PID.
+ */
+function killProcessTree(pid) {
+    if (process.platform !== 'win32')
+        return;
+    try {
+        const result = Bun.spawnSync(['taskkill', '/F', '/T', '/PID', String(pid)], {
+            stdout: 'pipe',
+            stderr: 'pipe',
+        });
+        if (result.exitCode !== 0) {
+            const stderr = new TextDecoder().decode(result.stderr);
+            // Exit code 128 = process not found (already exited) — not worth warning about
+            if (result.exitCode !== 128) {
+                console.error(`[killProcessTree] taskkill exited ${result.exitCode} for PID ${pid}: ${stderr.trim()}`);
+            }
+        }
+    }
+    catch {
+        /* best-effort — process may have already exited */
+    }
+}
+/**
+ * On Windows, Bun.spawn does NOT auto-append PATHEXT extensions like
+ * CreateProcess does. A bare command like `claude` fails with ENOENT if the
+ * actual file on disk is `claude.cmd` / `claude.bat` / `claude.ps1`. We
+ * manually resolve the command against PATH + PATHEXT here so Drivers can
+ * keep using short names (`claude`, `npx`, etc.) cross-platform.
+ *
+ * Results are cached by (cmd, envPath) key so repeated spawns of the same
+ * command don't block the event loop with synchronous PATH scans.
+ *
+ * Returns the original name if resolution fails; Bun will raise the same
+ * ENOENT it would have otherwise.
+ */
+const RESOLVED_EXE_CACHE_MAX = 128;
+const resolvedExeCache = new Map();
+/** Evict the oldest entry when the cache is at capacity. */
+function evictIfFull() {
+    if (resolvedExeCache.size >= RESOLVED_EXE_CACHE_MAX) {
+        // Map iteration order is insertion order — delete the first (oldest) key.
+        const oldest = resolvedExeCache.keys().next().value;
+        if (oldest !== undefined)
+            resolvedExeCache.delete(oldest);
+    }
+}
+function resolveWindowsExe(args, envPath) {
+    if (process.platform !== 'win32' || args.length === 0)
+        return args;
+    const cmd = args[0];
+    // Already a full path or has an extension → trust caller.
+    if (isAbsolute(cmd) || /\.[a-z0-9]+$/i.test(cmd))
+        return args;
+    const cacheKey = `${cmd}\x00${envPath}`;
+    if (resolvedExeCache.has(cacheKey)) {
+        // ?? null coerces undefined→null so cached is string|null and the !== null
+        // check narrows it to string without a spurious 'undefined' arm.
+        const cached = resolvedExeCache.get(cacheKey) ?? null;
+        return cached !== null ? [cached, ...args.slice(1)] : args;
+    }
+    const exts = (process.env.PATHEXT ??
+        '.COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH;.MSC')
+        .split(';')
+        .filter(Boolean);
+    const dirs = envPath.split(';').filter(Boolean);
+    for (const dir of dirs) {
+        for (const ext of exts) {
+            const candidate = join(dir, cmd + ext);
+            if (existsSync(candidate)) {
+                evictIfFull();
+                resolvedExeCache.set(cacheKey, candidate);
+                return [candidate, ...args.slice(1)];
+            }
+        }
+    }
+    evictIfFull();
+    resolvedExeCache.set(cacheKey, null);
+    return args;
+}
+/**
+ * H2: Build a "failed before spawn" result. Tagged as 'spawn_error' so the
+ * engine can show a useful classification ("driver tried to launch X but
+ * the binary wasn't found") rather than the misleading "timeout".
+ */
+function failResult(stderr, durationMs) {
+    return {
+        exitCode: -1,
+        stdout: '',
+        stderr,
+        outputPath: null,
+        stderrPath: null,
+        durationMs,
+        sessionId: null,
+        normalizedOutput: null,
+        failureKind: 'spawn_error',
+    };
+}
+/**
+ * R2: Validate a SpawnSpec returned by a third-party driver. Returns null on
+ * success or a human-readable error message describing the first violation.
+ *
+ * Catching this here is critical: an undetected bad spec ends up calling
+ * Bun.spawn with garbage and the resulting TypeError leaks into engine
+ * processTask's catch block as "Cannot read properties of undefined". By
+ * validating here we surface a clear "Driver X returned invalid args" message
+ * instead, and short-circuit before holding any process resources.
+ */
+export function validateSpawnSpec(spec, driverName) {
+    if (!spec || typeof spec !== 'object') {
+        return `Driver "${driverName}".buildCommand returned ${spec === null ? 'null' : typeof spec}, expected SpawnSpec object`;
+    }
+    const s = spec;
+    if (!Array.isArray(s.args)) {
+        return `Driver "${driverName}".buildCommand returned spec.args of type ${typeof s.args}, expected string[]`;
+    }
+    if (s.args.length === 0) {
+        return `Driver "${driverName}".buildCommand returned an empty spec.args array`;
+    }
+    for (let i = 0; i < s.args.length; i++) {
+        if (typeof s.args[i] !== 'string') {
+            return `Driver "${driverName}".buildCommand returned spec.args[${i}] of type ${typeof s.args[i]}, expected string`;
+        }
+    }
+    if (typeof s.args[0] !== 'string' || s.args[0].length === 0) {
+        return `Driver "${driverName}".buildCommand returned an empty executable name in spec.args[0]`;
+    }
+    if (s.cwd !== undefined && typeof s.cwd !== 'string') {
+        return `Driver "${driverName}".buildCommand returned spec.cwd of type ${typeof s.cwd}, expected string or undefined`;
+    }
+    if (s.stdin !== undefined && typeof s.stdin !== 'string') {
+        return `Driver "${driverName}".buildCommand returned spec.stdin of type ${typeof s.stdin}, expected string or undefined`;
+    }
+    if (s.env !== undefined) {
+        if (!s.env || typeof s.env !== 'object' || Array.isArray(s.env)) {
+            return `Driver "${driverName}".buildCommand returned spec.env that is not a plain object`;
+        }
+        for (const [k, v] of Object.entries(s.env)) {
+            if (typeof v !== 'string') {
+                return `Driver "${driverName}".buildCommand returned spec.env.${k} of type ${typeof v}, expected string`;
+            }
+        }
+    }
+    return null;
+}
+export async function runSpawn(spec, driver, opts = {}) {
+    const { timeoutMs, signal } = opts;
+    const start = performance.now();
+    const elapsed = () => Math.round(performance.now() - start);
+    // R2: validate the spec before touching it. A third-party driver that
+    // returns a malformed SpawnSpec used to crash deep inside Bun.spawn with
+    // an opaque TypeError; now we report a clear "Driver X returned …" message.
+    const validationError = validateSpawnSpec(spec, driver?.name ?? '<unknown>');
+    if (validationError !== null) {
+        return failResult(validationError, elapsed());
+    }
+    const mergedEnv = { ...process.env, ...(spec.env ?? {}) };
+    const resolvedArgs = resolveWindowsExe(spec.args, mergedEnv.PATH ?? process.env.PATH ?? '');
+    // ── 1. Spawn (catch ENOENT / bad-cwd up front) ────────────────────────
+    let proc;
+    try {
+        proc = Bun.spawn(resolvedArgs, {
+            cwd: spec.cwd,
+            env: mergedEnv,
+            stdout: 'pipe',
+            stderr: 'pipe',
+            stdin: spec.stdin ? 'pipe' : undefined,
+        });
+    }
+    catch (err) {
+        return failResult(String(err), elapsed());
+    }
+    // ── 2. Write stdin ─────────────────────────────────────────────────────
+    // Child may exit before reading (e.g. quick-fail commands that don't
+    // touch stdin) → swallow EPIPE rather than surfacing it as an
+    // engine-level error.
+    if (spec.stdin && proc.stdin && typeof proc.stdin !== 'number') {
+        try {
+            proc.stdin.write(spec.stdin);
+            proc.stdin.end();
+        }
+        catch {
+            /* ignore EPIPE / closed-pipe errors */
+        }
+    }
+    // ── 3. Timeout & abort handling ────────────────────────────────────────
+    let killedByUs = false;
+    let timedOut = false;
+    let timer = null;
+    let forceTimer = null;
+    const killGracefully = () => {
+        if (killedByUs)
+            return;
+        killedByUs = true;
+        if (process.platform === 'win32') {
+            // On Windows, kill the entire process tree via taskkill. This handles
+            // .cmd wrappers and nested child processes that proc.kill() misses.
+            killProcessTree(proc.pid);
+        }
+        else {
+            proc.kill('SIGTERM');
+            // If the child ignores SIGTERM, escalate to SIGKILL after 3 s.
+            forceTimer = setTimeout(() => {
+                try {
+                    proc.kill('SIGKILL');
+                }
+                catch {
+                    /* already exited */
+                }
+            }, SIGKILL_DELAY_MS);
+        }
+    };
+    if (timeoutMs && timeoutMs > 0) {
+        timer = setTimeout(() => {
+            timedOut = true;
+            killGracefully();
+        }, timeoutMs);
+    }
+    const onAbort = () => killGracefully();
+    if (signal) {
+        if (signal.aborted) {
+            killGracefully();
+        }
+        else {
+            signal.addEventListener('abort', onAbort, { once: true });
+        }
+    }
+    // ── 4. Collect output & wait (parallel to avoid pipe-buffer deadlock) ─
+    const stdoutStream = typeof proc.stdout === 'object' ? proc.stdout : undefined;
+    const stderrStream = typeof proc.stderr === 'object' ? proc.stderr : undefined;
+    const [exitCode, stdout, stderr] = await Promise.all([
+        proc.exited,
+        stdoutStream ? new Response(stdoutStream).text() : Promise.resolve(''),
+        stderrStream ? new Response(stderrStream).text() : Promise.resolve(''),
+    ]);
+    // ── 5. Cleanup timers & listeners ──────────────────────────────────────
+    if (timer)
+        clearTimeout(timer);
+    if (forceTimer)
+        clearTimeout(forceTimer);
+    if (signal)
+        signal.removeEventListener('abort', onAbort);
+    const durationMs = elapsed();
+    // We initiated the kill (timeout or abort) — always treat as non-success
+    // regardless of exit code. A process that catches SIGTERM and exits 0 still
+    // hit the timeout; letting it pass as success would unblock downstream tasks
+    // incorrectly. The `timedOut` flag guards against the narrow race where the
+    // process exits naturally at the exact moment the timeout fires — even if
+    // killedByUs wasn't set in time, the timeout intention still applies.
+    if (killedByUs || timedOut) {
+        return {
+            exitCode: -1,
+            stdout,
+            stderr,
+            outputPath: null,
+            stderrPath: null,
+            durationMs,
+            sessionId: null,
+            normalizedOutput: null,
+            // H2: explicit kind so engine.ts no longer has to guess "is exitCode -1
+            // a timeout or a spawn-failure?" Both used to share the same code.
+            failureKind: 'timeout',
+        };
+    }
+    // ── 6. Let driver extract metadata ─────────────────────────────────────
+    // R1: parseResult is third-party code — wrap it in try/catch so a buggy
+    // extractor doesn't discard a perfectly good spawn result. R5: even on
+    // success, type-guard sessionId/normalizedOutput so a mistyped return
+    // value doesn't poison sessionMap/normalizedMap downstream.
+    let sessionId = null;
+    let normalizedOutput = null;
+    // M12: drivers can flip a task's terminal status to failed even when the
+    // process exited 0 (e.g. opencode returning `{type:"error"}` JSON). When
+    // the flag is set, we synthesize a non-zero exit code and append a reason
+    // line to stderr so engine.ts marks the task as failed with a useful
+    // explanation instead of letting the error JSON pass through as success.
+    let forcedFailureMessage = null;
+    if (driver?.parseResult) {
+        try {
+            const meta = driver.parseResult(stdout, stderr);
+            if (meta && typeof meta === 'object') {
+                if (typeof meta.sessionId === 'string' && meta.sessionId.length > 0) {
+                    sessionId = meta.sessionId;
+                }
+                if (typeof meta.normalizedOutput === 'string') {
+                    normalizedOutput = meta.normalizedOutput;
+                }
+                if (meta.forceFailure === true) {
+                    forcedFailureMessage = typeof meta.forceFailureReason === 'string'
+                        ? meta.forceFailureReason
+                        : 'Driver flagged task as failed (forceFailure)';
+                }
+            }
+        }
+        catch (err) {
+            // The spawn itself succeeded; only metadata extraction failed.
+            // Fall through with sessionId/normalizedOutput = null and append a
+            // breadcrumb to stderr so the user can see WHY continue_from broke.
+            const msg = err instanceof Error ? err.message : String(err);
+            const note = `\n[runner] driver "${driver.name}".parseResult threw: ${msg}`;
+            return {
+                exitCode,
+                stdout,
+                stderr: stderr + note,
+                outputPath: null,
+                stderrPath: null,
+                durationMs,
+                sessionId: null,
+                normalizedOutput: null,
+                // H2: parseResult threw — the spawn itself succeeded, so the failure
+                // is "the process exited but the driver couldn't parse it". Surface
+                // that as exit_nonzero (when the actual exit was non-zero) or null
+                // (when the underlying exit was 0 — UI will still mark it failed via
+                // engine.ts because the result is incomplete).
+                failureKind: exitCode === 0 ? null : 'exit_nonzero',
+            };
+        }
+    }
+    // M12: when the driver forced a failure, treat as exit_nonzero with the
+    // reason appended to stderr so users see WHY the task failed without
+    // having to dig through driver-specific JSON.
+    if (forcedFailureMessage !== null) {
+        return {
+            exitCode: exitCode === 0 ? 1 : exitCode,
+            stdout,
+            stderr: stderr + (stderr.endsWith('\n') ? '' : '\n') + `[driver] ${forcedFailureMessage}`,
+            outputPath: null,
+            stderrPath: null,
+            durationMs,
+            sessionId,
+            normalizedOutput,
+            failureKind: 'exit_nonzero',
+        };
+    }
+    return {
+        exitCode,
+        stdout,
+        stderr,
+        outputPath: null,
+        stderrPath: null,
+        durationMs,
+        sessionId,
+        normalizedOutput,
+        // H2: success vs nonzero exit. Engine uses this to short-circuit the
+        // timeout branch even if a third-party driver returns -1 by mistake.
+        failureKind: exitCode === 0 ? null : 'exit_nonzero',
+    };
+}
+export async function runCommand(command, cwd, opts = {}) {
+    const spec = {
+        args: shellArgs(command),
+        cwd,
+    };
+    return runSpawn(spec, null, opts);
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,27 @@
+import type { PipelineConfig, RawPipelineConfig, RawTaskConfig } from './types';
+export declare function parseYaml(content: string): RawPipelineConfig;
+export declare function expandTemplates(tasks: readonly RawTaskConfig[], instancePrefix: string): Promise<RawTaskConfig[]>;
+export declare function resolveConfig(raw: RawPipelineConfig, workDir: string): PipelineConfig;
+/**
+ * Serialize a pipeline config back to YAML string.
+ * Wraps the config under the top-level `pipeline` key as expected by parseYaml.
+ */
+export declare function serializePipeline(config: PipelineConfig | RawPipelineConfig): string;
+/**
+ * Convert a resolved PipelineConfig back to a RawPipelineConfig for serialization.
+ * Strips injected defaults and converts absolute cwd paths back to relative so the
+ * resulting YAML is portable across machines.
+ *
+ * Use this when you need to save a config that was previously loaded via
+ * loadPipeline(). For a pure load→edit→save cycle on raw YAML, prefer
+ * parseYaml() → edit RawPipelineConfig → serializePipeline().
+ */
+export declare function deresolvePipeline(config: PipelineConfig, workDir: string): RawPipelineConfig;
+/**
+ * Validate a pipeline config without executing it.
+ * Only checks structural/DAG correctness — does not check plugin registration.
+ * Returns an array of error messages (empty = valid).
+ */
+export declare function validateConfig(config: PipelineConfig): string[];
+export declare function loadPipeline(yamlContent: string, workDir: string): Promise<PipelineConfig>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAAE,iBAAiB,EAAkB,aAAa,EAGjE,MAAM,SAAS,CAAC;AAOjB,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAa5D;AA+BD,wBAAsB,eAAe,CACnC,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC,CAgB1B;AA+ID,wBAAgB,aAAa,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAmFrF;AAWD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,iBAAiB,GAAG,MAAM,CAEpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA2D5F;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAQ/D;AAID,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAYhG"}