harness-dispatch 0.8.0 → 0.10.0

package/dist/jobs/read.js

@@ -0,0 +1,103 @@
+/**
+ * Reading a job back: one with its partial output, or the recent list.
+ *
+ * Separate from start.ts because the supervisor reads jobs while deciding
+ * what to run, and start.ts needs the supervisor — keeping the reads beside
+ * the start verbs closed that loop.
+ */
+import { existsSync } from "node:fs";
+import { readFile, readdir } from "node:fs/promises";
+import path from "node:path";
+import { assertValidJobId, jobsRoot, pollInstructions, readJson, SUGGESTED_POLL_SECONDS, withOrphanCheck, } from "./store.js";
+const MAX_PARTIAL_OUTPUT_CHARS = 4000;
+export async function getAsyncJob(jobId) {
+    assertValidJobId(jobId);
+    const jobDir = path.join(jobsRoot(), jobId);
+    // A well-formed id for a job that is gone is the ORDINARY case, not an
+    // internal error: retention prunes finished jobs, so any caller holding an
+    // id long enough will hit this. It used to surface as a raw Node ENOENT
+    // quoting an absolute path inside the jobs directory, which tells the caller
+    // nothing actionable and leaks the layout.
+    const noSuchJob = () => new Error(`No such job: ${jobId}. It may have been pruned by the retention window, ` +
+        `or it was never started on this machine.`);
+    if (!existsSync(path.join(jobDir, "manifest.json")))
+        throw noSuchJob();
+    let manifest;
+    let status;
+    let result;
+    try {
+        manifest = await readJson(path.join(jobDir, "manifest.json"));
+        status = withOrphanCheck(await readJson(path.join(jobDir, "status.json")));
+        const resultPath = path.join(jobDir, "output", "result.json");
+        result = existsSync(resultPath) ? await readJson(resultPath) : undefined;
+    }
+    catch (err) {
+        // existsSync-then-read is a TOCTOU window: retention pruning can delete
+        // the directory between the two calls, resurfacing the exact raw-ENOENT-
+        // with-an-absolute-path error this function's message exists to replace.
+        if (err?.code === "ENOENT")
+            throw noSuchJob();
+        throw err;
+    }
+    if (result !== undefined) {
+        return { manifest, status, result };
+    }
+    // Terminal: no poll guidance — polling will never resolve an orphaned job.
+    // But it still gets its partial output, which is the whole point of the
+    // record surviving the runner.
+    //
+    // This branch used to `return` here, ABOVE the partial-output read below, so
+    // an orphaned job handed back nothing at all while its progress sat in
+    // output/stdout.partial.log. PRODUCT.md's success criterion is explicit that
+    // a dispatch must never die returning nothing — "at worst it fails and hands
+    // back its latest progress… a wasted attempt with no trail is the defining
+    // failure" — and orphaning is exactly the case that criterion was written
+    // for: the supervisor died, so there is no result.json and the partial log
+    // is all that survived. An acceptance pass measured eight chunks of progress
+    // on disk and an empty response.
+    const terminalOrphan = status.status === "orphaned";
+    const out = {
+        manifest,
+        status: terminalOrphan
+            ? status
+            : {
+                ...status,
+                nextPollSeconds: SUGGESTED_POLL_SECONDS,
+                instructions: pollInstructions(jobId),
+            },
+    };
+    const partialPath = path.join(jobDir, "output", "stdout.partial.log");
+    if (existsSync(partialPath)) {
+        try {
+            const partial = await readFile(partialPath, "utf8");
+            out.partialOutput =
+                partial.length <= MAX_PARTIAL_OUTPUT_CHARS
+                    ? partial
+                    : `… [${partial.length - MAX_PARTIAL_OUTPUT_CHARS} chars omitted] …` +
+                        partial.slice(-MAX_PARTIAL_OUTPUT_CHARS);
+        }
+        catch {
+            // Best-effort; absence of partial output isn't an error.
+        }
+    }
+    return out;
+}
+export async function listAsyncJobs() {
+    const root = jobsRoot();
+    if (!existsSync(root))
+        return [];
+    const entries = await readdir(root, { withFileTypes: true });
+    const statuses = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        try {
+            statuses.push(withOrphanCheck(await readJson(path.join(root, entry.name, "status.json"))));
+        }
+        catch {
+            // Ignore incomplete or manually edited job directories.
+        }
+    }
+    return statuses.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+}
+//# sourceMappingURL=read.js.map

package/dist/jobs/read.js.map

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

package/dist/jobs/run.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Running one job: the work a runner process actually does.
+ *
+ * Split out of jobs.ts, which had grown to hold five concerns at 1,600 lines
+ * — this one, admission and the supervisor pool, the start/read verbs, and
+ * the lifecycle verbs. Nothing here was rewritten; the code moved.
+ */
+import type { JobDeps, JobManifest, StartJobInput } from "./types.js";
+export declare function runJob(deps: JobDeps, jobDir: string, manifest: JobManifest, input: StartJobInput): Promise<void>;
+/**
+ * Fallback dispatch timeout for jobs. Dispatchers hard-code a short default
+ * (10 min for CLI harnesses, 2 min for openai_compatible) meant to catch a
+ * genuinely hung process — waiting on stdin that'll never come, a stalled
+ * network call — not to cap a slow-but-healthy run. That default made sense
+ * as-is for `code`, which blocks an MCP call anyway, but `job` runs in the
+ * background and is polled, so nothing about it requires killing a process
+ * that's still making progress after 10 minutes. Below both an explicit
+ * `hints.timeoutMs` and the route's own configured `timeoutMs` in
+ * precedence, so this only fills the gap when nobody set either.
+ *
+ * Router.stream() treats this specific value as a budget for the WHOLE call
+ * (including router fallback retries), not a per-attempt allowance — without
+ * that, a job that falls back twice (the router's default maxFallbacks: 2)
+ * could burn up to 3x this value before failing conclusively.
+ */
+export declare const JOB_DEFAULT_TIMEOUT_MS: number;
+/**
+ * Rebuild a job's input from its on-disk bundle and execute it. This is the
+ * detached runner's whole job; the manifest deliberately carries everything
+ * a run needs (prompt path, resolved workingDir, hints, service) precisely
+ * so execution can happen in a process that wasn't there when the job was
+ * created.
+ */
+export declare function executeJobDir(deps: JobDeps, jobDir: string): Promise<void>;
+/** dist/job-runner.js next to this module (compiled), or via the package's dist/ when running from src. */
+export declare function resolveRunnerPath(): string | undefined;
+/**
+ * Watch a detached job's directory until it reaches a terminal state
+ * (result.json present, or a failed/orphaned status — the orphan check
+ * doubles as the exit path if the runner dies). Timer is unref'd: an
+ * exiting server abandons the watch, which is exactly the point of
+ * detached execution.
+ */
+export declare function watchUntilTerminal(jobDir: string): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/jobs/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/jobs/run.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAA+B,aAAa,EAAE,MAAM,YAAY,CAAC;AACnG,wBAAsB,MAAM,CAC1B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,IAAI,CAAC,CA4Of;AAMD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,QAAiB,CAAC;AAGrD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchF;AAED,2GAA2G;AAC3G,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAmBtD;AAID;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCtE"}

package/dist/jobs/run.js

@@ -0,0 +1,351 @@
+/**
+ * Running one job: the work a runner process actually does.
+ *
+ * Split out of jobs.ts, which had grown to hold five concerns at 1,600 lines
+ * — this one, admission and the supervisor pool, the start/read verbs, and
+ * the lifecycle verbs. Nothing here was rewritten; the code moved.
+ */
+import { existsSync } from "node:fs";
+import { redact } from "../redaction.js";
+import { appendFile, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { setTimeout as delay } from "node:timers/promises";
+import { fileURLToPath } from "node:url";
+import { boundedError, cancelReason, cancelRequested, readJson, timestamp, updateStatus, withOrphanCheck, writeJson, } from "./store.js";
+export async function runJob(deps, jobDir, manifest, input) {
+    const started = Date.now();
+    const runningStatus = () => ({
+        jobId: manifest.jobId,
+        status: "running",
+        createdAt: manifest.createdAt,
+        updatedAt: timestamp(),
+        jobDir,
+        ...(input.service !== undefined ? { service: input.service } : {}),
+        ...(manifest.warning !== undefined ? { warning: manifest.warning } : {}),
+    });
+    await updateStatus(jobDir, runningStatus());
+    // Heartbeat: bump updatedAt while the run is alive so a reader can tell
+    // "running" apart from "the server that owned this run died and left a
+    // stale status file" (getAsyncJob reports the latter as "orphaned").
+    // unref'd so an exiting process never lingers on it — which is exactly
+    // the scenario the heartbeat exists to expose. The `finished` flag stops
+    // a beat that FIRES after the terminal write; `pendingBeat` covers the
+    // beat that fired BEFORE it and is still mid-write — updateStatus's rename
+    // can back off ~900ms on Windows EPERM, long enough to land after the
+    // terminal status and re-mark a completed job "running" (then "orphaned"
+    // forever in the list view). The terminal paths await it before writing.
+    let finished = false;
+    let pendingBeat = Promise.resolve();
+    const heartbeat = setInterval(() => {
+        if (finished)
+            return;
+        pendingBeat = updateStatus(jobDir, runningStatus()).catch(() => undefined);
+    }, HEARTBEAT_INTERVAL_MS);
+    heartbeat.unref?.();
+    try {
+        const state = deps.holder.state;
+        const files = input.files ?? [];
+        // Reuse the value already resolved (and recorded) at job creation, not a
+        // fresh process.cwd() snapshot — the two must stay in sync with the
+        // warning captured in manifest.warning.
+        const workingDir = manifest.workingDir;
+        const hints = { ...(input.hints ?? {}) };
+        if (input.workspacePolicy !== undefined)
+            hints.workspacePolicy = input.workspacePolicy;
+        // Stream the dispatch so agents polling action=get can watch progress in
+        // stdout.partial.log instead of waiting blind for the final result.
+        const partialPath = path.join(jobDir, "output", "stdout.partial.log");
+        // Cancellation travels DOWN to the child process, not up through the
+        // iterator. Returning from an async generator that is suspended at an
+        // `await` does not take effect until that await settles — which for an
+        // agent CLI gone quiet is never — so the only thing that reliably stops a
+        // silent run is aborting the subprocess (or fetch) directly.
+        const cancelController = new AbortController();
+        const events = input.service
+            ? state.router.streamTo(input.service, input.prompt, files, workingDir, {
+                ...(hints.safetyProfile !== undefined
+                    ? { safetyProfile: hints.safetyProfile }
+                    : {}),
+                ...(hints.workspacePolicy !== undefined
+                    ? { workspacePolicy: hints.workspacePolicy }
+                    : {}),
+                ...(hints.routePolicy !== undefined
+                    ? { routePolicy: hints.routePolicy }
+                    : {}),
+                ...(hints.model !== undefined ? { model: hints.model } : {}),
+                ...(hints.taskType !== undefined ? { taskType: hints.taskType } : {}),
+                ...(hints.timeoutMs !== undefined ? { timeoutMs: hints.timeoutMs } : {}),
+                defaultTimeoutMs: JOB_DEFAULT_TIMEOUT_MS,
+                signal: cancelController.signal,
+            })
+            : state.router.stream(input.prompt, files, workingDir, {
+                hints,
+                maxFallbacks: 2,
+                defaultTimeoutMs: JOB_DEFAULT_TIMEOUT_MS,
+                signal: cancelController.signal,
+            });
+        let finalResult = null;
+        let finalDecision = null;
+        let cancelled = false;
+        // Driven through an explicit iterator rather than `for await`, so a
+        // cancellation can interrupt a stream that is producing NOTHING. A
+        // for-await body only runs when an event arrives, and the case that most
+        // needs cancelling is the agent that has gone quiet for twenty minutes.
+        // Racing next() against a poll lets us stop either way, and calling
+        // return() on the iterator is what tears the child process down —
+        // stream-subprocess's return() runs killTree, which on POSIX now signals
+        // the whole process group.
+        const iterator = events[Symbol.asyncIterator]();
+        const CANCEL_POLL_MS = 1_000;
+        // The in-flight next() is held ACROSS polls rather than re-issued.
+        // Racing a fresh iterator.next() each time round drops events: when the
+        // poll wins, the previous next() is still pending, and calling next()
+        // again queues a second pull whose result is the one we read — the first
+        // event resolves into nothing. Losing a `completion` that way leaves a
+        // finished run with no result.json, so the job never reaches a terminal
+        // state and the caller polls a corpse. Caught by the slot-queue test,
+        // which waits for a queued job to actually complete.
+        let pending;
+        for (;;) {
+            pending ??= iterator.next();
+            const winner = await Promise.race([
+                pending.then((r) => ({ kind: "event", r })),
+                delay(CANCEL_POLL_MS, { kind: "poll" }, { ref: false }),
+            ]);
+            if (winner.kind === "poll") {
+                if (!cancelRequested(jobDir))
+                    continue; // `pending` deliberately kept
+                cancelled = true;
+                cancelController.abort();
+                // Not awaited: the generator is parked on an await that only settles
+                // once the abort above kills the child, so awaiting return() here
+                // would deadlock on the very thing it is trying to stop.
+                void iterator.return?.().catch(() => undefined);
+                break;
+            }
+            pending = undefined;
+            const next = winner.r;
+            if (next.done)
+                break;
+            if (cancelRequested(jobDir)) {
+                cancelled = true;
+                cancelController.abort();
+                void iterator.return?.().catch(() => undefined);
+                break;
+            }
+            const { event, decision } = next.value;
+            if (decision)
+                finalDecision = decision;
+            if (input.onEvent) {
+                try {
+                    input.onEvent(event);
+                }
+                catch {
+                    // Progress forwarding is best-effort; the job itself must not fail.
+                }
+            }
+            if (event.type === "stdout" || event.type === "stderr") {
+                try {
+                    await appendFile(partialPath, redact(event.chunk), { encoding: "utf8", mode: 0o600 });
+                }
+                catch {
+                    // Progress mirroring is best-effort; the final result still lands.
+                }
+            }
+            else if (event.type === "completion") {
+                // Fallback chains yield one completion per attempt; last one wins.
+                finalResult = event.result;
+            }
+        }
+        if (cancelled) {
+            // Terminal, and deliberately NOT routed through the result/failure path:
+            // no result.json is written and the router never sees a failure, so a
+            // cancellation cannot charge the route's breaker or failure count for
+            // the caller changing their mind.
+            finished = true;
+            await pendingBeat;
+            const reason = await cancelReason(jobDir);
+            await updateStatus(jobDir, {
+                jobId: manifest.jobId,
+                status: "cancelled",
+                createdAt: manifest.createdAt,
+                updatedAt: timestamp(),
+                jobDir,
+                ...(input.service !== undefined ? { service: input.service } : {}),
+                success: false,
+                error: reason !== undefined ? `Cancelled: ${reason}` : "Cancelled before it finished.",
+                ...(manifest.warning !== undefined ? { warning: manifest.warning } : {}),
+                durationMs: Date.now() - started,
+            });
+            return;
+        }
+        const result = finalResult ?? {
+            output: "",
+            service: input.service ?? "none",
+            success: false,
+            error: "Router stream ended without a completion event",
+        };
+        finished = true;
+        await pendingBeat;
+        const payload = {
+            jobId: manifest.jobId,
+            result: { ...result, ...(result.error !== undefined ? { error: boundedError(result.error) } : {}) },
+            decision: finalDecision,
+        };
+        await writeFile(path.join(jobDir, "output", "stdout.log"), redact(result.output), { encoding: "utf8", mode: 0o600 });
+        await writeFile(path.join(jobDir, "output", "stderr.log"), redact(result.error ?? ""), { encoding: "utf8", mode: 0o600 });
+        await writeJson(path.join(jobDir, "output", "result.json"), payload);
+        await writeFile(path.join(jobDir, "output", "result.md"), redact(result.output || result.error || ""), { encoding: "utf8", mode: 0o600 });
+        await updateStatus(jobDir, {
+            jobId: manifest.jobId,
+            status: result.success ? "completed" : "failed",
+            createdAt: manifest.createdAt,
+            updatedAt: timestamp(),
+            jobDir,
+            ...(input.service !== undefined ? { service: input.service } : {}),
+            route: result.service,
+            success: result.success,
+            ...(result.error !== undefined ? { error: boundedError(result.error) } : {}),
+            ...(manifest.warning !== undefined ? { warning: manifest.warning } : {}),
+            durationMs: Date.now() - started,
+        });
+    }
+    catch (err) {
+        finished = true;
+        await pendingBeat;
+        const message = err instanceof Error ? err.message : String(err);
+        try {
+            // The sibling of the success path 25 lines up, which redacts. Missing
+            // this one is the same one-branch-of-a-pair miss the chokepoint exists
+            // to make impossible, found in the very file the chokepoint edited.
+            await writeFile(path.join(jobDir, "output", "stderr.log"), redact(message), {
+                encoding: "utf8",
+                mode: 0o600,
+            });
+            await updateStatus(jobDir, {
+                jobId: manifest.jobId,
+                status: "failed",
+                createdAt: manifest.createdAt,
+                updatedAt: timestamp(),
+                jobDir,
+                ...(input.service !== undefined ? { service: input.service } : {}),
+                success: false,
+                error: boundedError(message),
+                ...(manifest.warning !== undefined ? { warning: manifest.warning } : {}),
+                durationMs: Date.now() - started,
+            });
+        }
+        catch {
+            // The job directory can be GONE by the time a failure is recorded —
+            // retention pruning, or a caller that tore down its state mid-run.
+            // There is nowhere to write and no reader left to care; throwing here
+            // would reject `completion`, which is documented to never reject (and
+            // surfaced in CI as an unhandled rejection out of a finished test).
+        }
+    }
+    finally {
+        clearInterval(heartbeat);
+    }
+}
+/** How often a live background run bumps its status file's updatedAt. */
+const HEARTBEAT_INTERVAL_MS = 15_000;
+/**
+ * Fallback dispatch timeout for jobs. Dispatchers hard-code a short default
+ * (10 min for CLI harnesses, 2 min for openai_compatible) meant to catch a
+ * genuinely hung process — waiting on stdin that'll never come, a stalled
+ * network call — not to cap a slow-but-healthy run. That default made sense
+ * as-is for `code`, which blocks an MCP call anyway, but `job` runs in the
+ * background and is polled, so nothing about it requires killing a process
+ * that's still making progress after 10 minutes. Below both an explicit
+ * `hints.timeoutMs` and the route's own configured `timeoutMs` in
+ * precedence, so this only fills the gap when nobody set either.
+ *
+ * Router.stream() treats this specific value as a budget for the WHOLE call
+ * (including router fallback retries), not a per-attempt allowance — without
+ * that, a job that falls back twice (the router's default maxFallbacks: 2)
+ * could burn up to 3x this value before failing conclusively.
+ */
+export const JOB_DEFAULT_TIMEOUT_MS = 60 * 60 * 1000;
+/**
+ * Rebuild a job's input from its on-disk bundle and execute it. This is the
+ * detached runner's whole job; the manifest deliberately carries everything
+ * a run needs (prompt path, resolved workingDir, hints, service) precisely
+ * so execution can happen in a process that wasn't there when the job was
+ * created.
+ */
+export async function executeJobDir(deps, jobDir) {
+    const manifest = await readJson(path.join(jobDir, "manifest.json"));
+    const prompt = await readFile(manifest.promptPath, "utf8");
+    const input = {
+        prompt,
+        files: manifest.files.map((f) => f.originalPath),
+        workingDir: manifest.workingDir,
+        ...(manifest.hints !== undefined ? { hints: manifest.hints } : {}),
+        ...(manifest.workspacePolicy !== undefined
+            ? { workspacePolicy: manifest.workspacePolicy }
+            : {}),
+        ...(manifest.service !== undefined ? { service: manifest.service } : {}),
+    };
+    await runJob(deps, jobDir, manifest, input);
+}
+/** dist/job-runner.js next to this module (compiled), or via the package's dist/ when running from src. */
+export function resolveRunnerPath() {
+    // Resolved against THIS module's own location, which is a trap worth
+    // stating: the candidates below have to be updated whenever this function
+    // moves between directories. Splitting jobs.ts moved it from `dist/` down
+    // into `dist/jobs/`, both candidates missed, and the function returned
+    // undefined — which is not an error anywhere, it is the signal to run the
+    // job IN-PROCESS. So every dispatch quietly stopped being detached and the
+    // concurrency gate stopped firing, with nothing failing until the job
+    // concurrency tests ran.
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        // dist/jobs/run.js -> dist/job-runner.js (the built layout today)
+        path.join(here, "..", "job-runner.js"),
+        // Beside this file, if the build ever flattens or co-locates it.
+        path.join(here, "job-runner.js"),
+        // src/jobs/run.ts with a dist/ build present (unbuilt checkout, tests).
+        path.join(here, "..", "..", "dist", "job-runner.js"),
+    ];
+    return candidates.find((candidate) => existsSync(candidate));
+}
+const TERMINAL_WATCH_INTERVAL_MS = 300;
+/**
+ * Watch a detached job's directory until it reaches a terminal state
+ * (result.json present, or a failed/orphaned status — the orphan check
+ * doubles as the exit path if the runner dies). Timer is unref'd: an
+ * exiting server abandons the watch, which is exactly the point of
+ * detached execution.
+ */
+export async function watchUntilTerminal(jobDir) {
+    const deadline = Date.now() + JOB_DEFAULT_TIMEOUT_MS + 10 * 60 * 1000;
+    while (Date.now() < deadline) {
+        // Waits for a terminal STATUS, deliberately not for result.json.
+        //
+        // runJob writes result.json and then updates the status, so returning on
+        // result.json alone let this resolve in the window between the two: a
+        // caller could `await` a job and then read `status: "running"` from the
+        // job it had just been told was finished. Observed on Windows CI as
+        // "expected 'running' to be 'completed'".
+        //
+        // Because the status write comes last, a terminal status implies the
+        // result is already on disk — the ordering does the synchronising, so no
+        // extra check is needed here. A runner that dies between the two writes
+        // is covered by withOrphanCheck below, which is the same exit path as any
+        // other dead runner.
+        try {
+            const status = withOrphanCheck(await readJson(path.join(jobDir, "status.json")));
+            if (status.status === "completed" ||
+                status.status === "failed" ||
+                status.status === "orphaned" ||
+                status.status === "cancelled") {
+                return;
+            }
+        }
+        catch {
+            // Transient read during an atomic rename — retry next tick.
+        }
+        await delay(TERMINAL_WATCH_INTERVAL_MS, undefined, { ref: false });
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/jobs/run.js.map

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

package/dist/jobs/start.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Starting a job.
+ *
+ * Split out of jobs.ts with the rest of its concerns; nothing was rewritten.
+ */
+import type { JobDeps, JobStatus, StartedJob, StartJobInput } from "./types.js";
+export declare function startAsyncJob(deps: JobDeps, input: StartJobInput): Promise<JobStatus>;
+export declare function startAsyncJobTracked(deps: JobDeps, input: StartJobInput): Promise<StartedJob>;
+//# sourceMappingURL=start.d.ts.map

package/dist/jobs/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/jobs/start.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmBH,OAAO,KAAK,EAAE,OAAO,EAAe,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAM7F,wBAAsB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAE3F;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAmHnG"}