@llm4ts/shell 2.45.0 → 2.46.0

package/dist/RunSupervisor.js

@@ -0,0 +1,282 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import * as Clock from "effect/Clock";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Ref from "effect/Ref";
+import * as Scope from "effect/Scope";
+import * as Semaphore from "effect/Semaphore";
+import { encodeOperatorRunLine, latestRuns, OperatorRun, RunInProgress, UnknownRun } from "@llm4ts/flow/OperatorSchemas";
+/**
+ * Where the operator keeps one repository's registry and run logs:
+ * `${XDG_STATE_HOME:-~/.local/state}/llm4ts/mcp/<repoId>`. An empty
+ * `XDG_STATE_HOME` counts as unset; never under `<repo>/.llm4ts/`.
+ */
+export const operatorStateDir = (environment, repoId) => {
+    const home = environment.HOME !== undefined && environment.HOME.length > 0 ? environment.HOME : homedir();
+    const stateHome = environment.XDG_STATE_HOME !== undefined && environment.XDG_STATE_HOME.length > 0
+        ? environment.XDG_STATE_HOME
+        : join(home, ".local", "state");
+    return join(stateHome, "llm4ts", "mcp", repoId);
+};
+/** Knobs that become the flow's argv, in a fixed order; `flags` come last. */
+export const knobsToArgs = (_flow, knobs) => [
+    ...(knobs.task === undefined ? [] : [knobs.task]),
+    ...(knobs.epic === undefined ? [] : ["--epic", knobs.epic]),
+    ...(knobs.land === undefined ? [] : [`--land=${knobs.land}`]),
+    ...(knobs.judgeRounds === undefined ? [] : ["--judge-rounds", String(knobs.judgeRounds)]),
+    ...(knobs.mergeRevisions === undefined
+        ? []
+        : ["--merge-revisions", String(knobs.mergeRevisions)]),
+    ...(knobs.flags ?? [])
+];
+/** The only knobs that reach the flow's environment. */
+export const knobsToEnvironment = (knobs) => ({
+    ...(knobs.executors === undefined ? {} : { LLM4TS_EXECUTORS: knobs.executors.join(",") }),
+    ...(knobs.pack === undefined ? {} : { LLM4TS_PACK: knobs.pack }),
+    ...(knobs.coder === undefined ? {} : { LLM4TS_CODER: knobs.coder })
+});
+const randomHex = () => Math.floor(Math.random() * 0x10000)
+    .toString(16)
+    .padStart(4, "0");
+const isActive = (run) => run.state === "starting" || run.state === "running";
+/** The server's own bearer token never reaches a child flow. */
+const childEnvironment = (base) => Object.fromEntries(Object.entries(base).filter(([name]) => name !== "LLM4TS_MCP_TOKEN"));
+export const makeRunSupervisor = (options) => Effect.gen(function* () {
+    const graceMs = options.graceMs ?? 30_000;
+    const readOnlyFlows = options.readOnlyFlows ?? new Set(["epic-retro"]);
+    const random = options.random ?? randomHex;
+    const stateDir = (repoId) => operatorStateDir(options.environment, repoId);
+    const registryPath = (repoId) => join(stateDir(repoId), "runs.jsonl");
+    const readRepo = (repoId) => options.files
+        .read(registryPath(repoId))
+        .pipe(Effect.map((contents) => latestRuns((contents ?? "").split("\n"))));
+    const record = (run) => options.files.append(registryPath(run.repo), `${encodeOperatorRunLine(run)}\n`);
+    const withState = (run, fields) => new OperatorRun({ ...run, ...fields });
+    // Runs whose child died while no supervisor watched them.
+    for (const repo of options.repos) {
+        for (const run of yield* readRepo(repo.id)) {
+            if (isActive(run) && (run.pid === undefined || !options.process.isAlive(run.pid))) {
+                const endedAt = yield* Clock.currentTimeMillis;
+                yield* record(withState(run, { state: "lost", endedAt }));
+            }
+        }
+    }
+    const live = new Map();
+    // Runs between their `starting` record and their `live` entry.
+    const launching = new Set();
+    // Orphan runs (alive, left by an earlier server) a `stop` already
+    // signalled, with the outcome of their escalation.
+    const orphansStopping = new Map();
+    const lock = yield* Semaphore.make(1);
+    const watchers = yield* Scope.make();
+    const isOrphan = (run) => isActive(run) && !live.has(run.runId) && !launching.has(run.runId);
+    // An active record nobody here watches: a run from an earlier server.
+    // Its child is re-checked lazily; once gone the record becomes `lost`.
+    const reconcile = (run) => Effect.gen(function* () {
+        if (!isOrphan(run) || (run.pid !== undefined && options.process.isAlive(run.pid))) {
+            return run;
+        }
+        const endedAt = yield* Clock.currentTimeMillis;
+        const lost = withState(run, { state: "lost", endedAt });
+        yield* record(lost);
+        return lost;
+    });
+    const readRepoLive = (repoId) => readRepo(repoId).pipe(Effect.flatMap((runs) => Effect.forEach(runs, reconcile)));
+    const allRuns = (repoId) => Effect.forEach(options.repos.filter((repo) => repoId === undefined || repo.id === repoId), (repo) => readRepoLive(repo.id)).pipe(Effect.map((perRepo) => perRepo.flat().sort((a, b) => b.startedAt - a.startedAt)), Effect.orDie);
+    const get = (runId) => allRuns().pipe(Effect.map((runs) => runs.find((run) => run.runId === runId)));
+    const watch = (running, entry) => Effect.gen(function* () {
+        const exit = yield* entry.handle.exited;
+        const stopped = yield* Ref.get(entry.stopping);
+        const endedAt = yield* Clock.currentTimeMillis;
+        const final = withState(running, {
+            state: stopped ? "interrupted" : "exited",
+            endedAt,
+            ...(exit.code === undefined ? {} : { exitCode: exit.code }),
+            ...(exit.signal === undefined ? {} : { signal: exit.signal })
+        });
+        // A failed append leaves the record active; with the child gone, the
+        // next read reconciles it to `lost`. `stop` must not wait on it.
+        yield* record(final).pipe(Effect.ignore, Effect.ensuring(Effect.suspend(() => {
+            live.delete(running.runId);
+            return Deferred.succeed(entry.final, final);
+        })));
+    });
+    const start = (request) => lock.withPermits(1)(Effect.gen(function* () {
+        const existing = yield* readRepoLive(request.repo.id);
+        const requestId = request.knobs.requestId;
+        if (requestId !== undefined) {
+            const repeated = existing.find((run) => run.requestId === requestId);
+            if (repeated !== undefined)
+                return repeated;
+        }
+        if (!readOnlyFlows.has(request.flow.name)) {
+            const busy = existing.filter((run) => isActive(run) && !readOnlyFlows.has(run.flow));
+            const [newest] = busy;
+            if (newest !== undefined && busy.length >= options.parallelRuns) {
+                return yield* new RunInProgress({
+                    message: `${request.repo.id} already runs ${newest.flow} (${newest.runId})`,
+                    runId: newest.runId
+                });
+            }
+        }
+        const startedAt = yield* Clock.currentTimeMillis;
+        const taken = (id) => live.has(id) || existing.some((run) => run.runId === id);
+        let runId = `op-${startedAt}-${random()}`;
+        for (let attempt = 0; attempt < 16 && taken(runId); attempt++) {
+            runId = `op-${startedAt}-${random()}`;
+        }
+        const tracePath = join(request.repo.path, ".llm4ts", `trace-${startedAt}.jsonl`);
+        const logDir = join(stateDir(request.repo.id), "runs", runId);
+        const args = knobsToArgs(request.flow.name, request.knobs);
+        const starting = new OperatorRun({
+            runId,
+            repo: request.repo.id,
+            flow: request.flow.name,
+            args,
+            knobs: request.knobs,
+            startedAt,
+            tracePath,
+            logDir,
+            state: "starting",
+            ...(requestId === undefined ? {} : { requestId })
+        });
+        launching.add(runId);
+        return yield* Effect.gen(function* () {
+            yield* record(starting);
+            const handle = yield* options.process
+                .start({
+                flowPath: request.flow.path,
+                args,
+                environment: {
+                    ...childEnvironment(request.baseEnvironment),
+                    ...knobsToEnvironment(request.knobs),
+                    LLM4TS_RUN_ID: runId,
+                    LLM4TS_TRACE_PATH: tracePath,
+                    LLM4TS_FLOW: request.flow.name
+                },
+                cwd: request.repo.path,
+                stdio: { stdout: join(logDir, "stdout.log"), stderr: join(logDir, "stderr.log") },
+                detached: true
+            })
+                .pipe(Effect.tapError(() => Effect.gen(function* () {
+                const endedAt = yield* Clock.currentTimeMillis;
+                yield* record(withState(starting, { state: "exited", endedAt }));
+            })));
+            const running = withState(starting, { state: "running", pid: handle.pid });
+            yield* record(running);
+            const entry = {
+                handle,
+                stopping: yield* Ref.make(false),
+                final: yield* Deferred.make()
+            };
+            live.set(runId, entry);
+            yield* Effect.forkIn(watch(running, entry), watchers);
+            return running;
+        }).pipe(Effect.ensuring(Effect.sync(() => launching.delete(runId))));
+    }));
+    // Polls until the pid is gone or `ms` elapses; true when it is gone.
+    const awaitGone = (pid, ms) => Effect.gen(function* () {
+        const step = Math.max(1, Math.min(250, ms));
+        for (let waited = 0; waited < ms; waited += step) {
+            if (!options.process.isAlive(pid))
+                return true;
+            yield* Effect.sleep(step);
+        }
+        return !options.process.isAlive(pid);
+    });
+    // A live run's signal-and-escalate sequence. It runs in `watchers`, not
+    // in the caller's fiber, so a cancelled `stop` still sends SIGTERM.
+    const escalate = (entry) => Effect.gen(function* () {
+        if (yield* Deferred.isDone(entry.final))
+            return;
+        yield* entry.handle.signal("SIGINT");
+        const graceful = yield* Deferred.await(entry.final).pipe(Effect.timeoutOption(graceMs));
+        if (graceful._tag === "None")
+            yield* entry.handle.signal("SIGTERM");
+    });
+    // The same for an orphan, by pid. It records `interrupted` once the pid
+    // is gone and always completes `outcome`, even when interrupted.
+    const escalateOrphan = (run, pid, outcome) => Effect.gen(function* () {
+        yield* options.process.signal(pid, "SIGINT");
+        let gone = yield* awaitGone(pid, graceMs);
+        if (!gone) {
+            yield* options.process.signal(pid, "SIGTERM");
+            gone = yield* awaitGone(pid, graceMs);
+        }
+        if (!gone)
+            return;
+        const endedAt = yield* Clock.currentTimeMillis;
+        const interrupted = withState(run, { state: "interrupted", endedAt });
+        yield* record(interrupted).pipe(Effect.ignore);
+        yield* Deferred.succeed(outcome, interrupted);
+    }).pipe(Effect.ensuring(Deferred.succeed(outcome, run)));
+    const stopOrphan = (run, pid) => Effect.gen(function* () {
+        const candidate = yield* Deferred.make();
+        // Check-and-set and fork with no interruption point between them:
+        // only the first stop signals, and its escalation always starts.
+        const outcome = yield* Effect.uninterruptible(Effect.gen(function* () {
+            const existing = orphansStopping.get(run.runId);
+            if (existing !== undefined)
+                return existing;
+            orphansStopping.set(run.runId, candidate);
+            yield* Effect.forkIn(escalateOrphan(run, pid, candidate), watchers);
+            return candidate;
+        }));
+        const result = yield* Deferred.await(outcome);
+        if (!isActive(result))
+            return result;
+        // The child ignored SIGTERM too: report where the registry stands.
+        return (yield* get(run.runId)) ?? result;
+    });
+    const stop = (runId) => Effect.gen(function* () {
+        const entry = live.get(runId);
+        if (entry === undefined) {
+            const known = yield* get(runId);
+            if (known === undefined) {
+                return yield* new UnknownRun({ message: `no run ${runId}` });
+            }
+            if (isOrphan(known) && known.pid !== undefined) {
+                return yield* stopOrphan(known, known.pid);
+            }
+            return known;
+        }
+        // Only the first stop signals: a second SIGINT kills a flow at once.
+        // The winner forks the escalation into `watchers`; every caller,
+        // the winner included, only awaits the outcome.
+        yield* Effect.uninterruptible(Effect.gen(function* () {
+            const already = yield* Ref.getAndSet(entry.stopping, true);
+            if (!already)
+                yield* Effect.forkIn(escalate(entry), watchers);
+        }));
+        const graceful = yield* Deferred.await(entry.final).pipe(Effect.timeoutOption(graceMs));
+        if (graceful._tag === "Some")
+            return graceful.value;
+        const forced = yield* Deferred.await(entry.final).pipe(Effect.timeoutOption(graceMs));
+        if (forced._tag === "Some")
+            return forced.value;
+        // The child ignored SIGTERM too: report where the registry stands.
+        const latest = yield* get(runId);
+        return latest ?? (yield* new UnknownRun({ message: `no run ${runId}` }));
+    });
+    // Live runs are stopped (their escalations finish within the stop's
+    // wait) and pending orphan escalations awaited before `watchers` closes.
+    yield* Effect.addFinalizer(() => Effect.all([
+        Effect.forEach([...live.keys()], (runId) => Effect.ignore(stop(runId)), {
+            concurrency: "unbounded",
+            discard: true
+        }),
+        Effect.forEach([...orphansStopping.values()], Deferred.await, {
+            concurrency: "unbounded",
+            discard: true
+        })
+    ], { concurrency: "unbounded", discard: true }).pipe(Effect.andThen(Scope.close(watchers, Exit.void))));
+    return {
+        start,
+        stop,
+        get,
+        list: allRuns
+    };
+});
+//# sourceMappingURL=RunSupervisor.js.map

package/dist/RunSupervisor.js.map

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

package/dist/ShellErrors.d.ts

@@ -0,0 +1,9 @@
+import * as Schema from "effect/Schema";
+declare const ShellUsageError_base: Schema.Class<ShellUsageError, Schema.TaggedStruct<"ShellUsage", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** Shared so modules that `Cli.ts` imports can fail with it without an import cycle. */
+export declare class ShellUsageError extends ShellUsageError_base {
+}
+export {};
+//# sourceMappingURL=ShellErrors.d.ts.map

package/dist/ShellErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellErrors.d.ts","sourceRoot":"","sources":["../src/ShellErrors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;;;;AAEvC,wFAAwF;AACxF,qBAAa,eAAgB,SAAQ,oBAEnC;CAAG"}

package/dist/ShellErrors.js

@@ -0,0 +1,7 @@
+import * as Schema from "effect/Schema";
+/** Shared so modules that `Cli.ts` imports can fail with it without an import cycle. */
+export class ShellUsageError extends Schema.TaggedError()("ShellUsage", {
+    message: Schema.String
+}) {
+}
+//# sourceMappingURL=ShellErrors.js.map

package/dist/ShellErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellErrors.js","sourceRoot":"","sources":["../src/ShellErrors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,wFAAwF;AACxF,MAAM,OAAO,eAAgB,SAAQ,MAAM,CAAC,WAAW,EAAmB,CAAC,YAAY,EAAE;IACvF,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC;CAAG"}

package/flows/port-guide.js

@@ -85,7 +85,10 @@ const program = Effect.gen(function* () {
         coder,
         reasoning: asReadOnly(coder),
         reviewers: [asReadOnly(coder)],
-        environment: process.env
+        environment: process.env,
+        // The trial ports are written under `.llm4ts/port/trial/` by the
+        // coder itself, so this run lifts the default deny of the run state.
+        deniedPaths: []
     }, (context) => Effect.gen(function* () {
         const events = context.events;
         const repo = yield* makeNodeWorkspace(input.workDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llm4ts/shell",
-  "version": "2.45.0",
+  "version": "2.46.0",
   "description": "Interactive shell and CLI for llm4ts: flow discovery, run-a-flow, and view",
   "license": "MIT",
   "type": "module",
@@ -22,9 +22,18 @@
     "./CoderChoice": "./dist/CoderChoice.js",
     "./FlowCatalog": "./dist/FlowCatalog.js",
     "./FlowLaunch": "./dist/FlowLaunch.js",
+    "./FlowProcess": "./dist/FlowProcess.js",
     "./Menu": "./dist/Menu.js",
+    "./OperatorActTools": "./dist/OperatorActTools.js",
+    "./OperatorConfig": "./dist/OperatorConfig.js",
+    "./OperatorNode": "./dist/OperatorNode.js",
+    "./OperatorRuns": "./dist/OperatorRuns.js",
+    "./OperatorServer": "./dist/OperatorServer.js",
+    "./OperatorTools": "./dist/OperatorTools.js",
     "./Refine": "./dist/Refine.js",
+    "./RunSupervisor": "./dist/RunSupervisor.js",
     "./Package": "./dist/Package.js",
+    "./ShellErrors": "./dist/ShellErrors.js",
     "./package.json": "./package.json"
   },
   "publishConfig": {
@@ -52,9 +61,9 @@
   "dependencies": {
     "@effect/platform-node": "4.0.0",
     "@effect/platform-node-shared": "4.0.0",
-    "@llm4ts/flow": "2.45.0",
-    "@llm4ts/core": "2.45.0",
-    "@llm4ts/runner": "2.45.0"
+    "@llm4ts/core": "2.46.0",
+    "@llm4ts/runner": "2.46.0",
+    "@llm4ts/flow": "2.46.0"
   },
   "peerDependencies": {
     "effect": "4.0.0"

package/src/Cli.ts

@@ -50,13 +50,14 @@ import {
   type FlowTierPaths
 } from "./FlowCatalog.ts"
 import { launchFlow } from "./FlowLaunch.ts"
+import { mcpOptionsFrom } from "./OperatorConfig.ts"
+import { nodeOperatorRuntime, nodeRead, runMcp } from "./OperatorNode.ts"
 import { mainMenu } from "./Menu.ts"
 import { ModDir, refineSession } from "./Refine.ts"
 import { packageVersion } from "./Package.ts"
+import { ShellUsageError } from "./ShellErrors.ts"
 
-export class ShellUsageError extends Schema.TaggedError<ShellUsageError>()("ShellUsage", {
-  message: Schema.String
-}) {}
+export { ShellUsageError }
 
 export class ShellActionError extends Schema.TaggedError<ShellActionError>()("ShellAction", {
   message: Schema.String
@@ -981,6 +982,65 @@ const geminiBridgeCommand = Command.make(
   )
 )
 
+const mcpCommand = Command.make(
+  "mcp",
+  {
+    stdio: Flag.Boolean("stdio").pipe(
+      Flag.withDefault(false),
+      Flag.withDescription("Speak MCP on stdin/stdout (the default transport)")
+    ),
+    http: Flag.Boolean("http").pipe(
+      Flag.withDefault(false),
+      Flag.withDescription(
+        "Serve MCP over HTTP at /mcp; needs a bearer token from LLM4TS_MCP_TOKEN or --token-file"
+      )
+    ),
+    host: Flag.String("host").pipe(
+      Flag.optional,
+      Flag.withDescription("HTTP host to bind (default 127.0.0.1)")
+    ),
+    port: Flag.Int("port").pipe(Flag.optional, Flag.withDescription("HTTP port (default 4321)")),
+    tokenFile: Flag.String("token-file").pipe(
+      Flag.optional,
+      Flag.withDescription("File holding the HTTP bearer token (when LLM4TS_MCP_TOKEN is unset)")
+    ),
+    repo: Flag.String("repo").pipe(
+      Flag.atLeast(0),
+      Flag.withDescription(
+        "Repository to serve, repeatable (default: the repos in ~/.config/llm4ts/mcp.json)"
+      )
+    ),
+    allowRun: Flag.Boolean("allow-run").pipe(
+      Flag.withDefault(false),
+      Flag.withDescription("Offer the tools that start, stop and resume flows")
+    ),
+    allowApprove: Flag.Boolean("allow-approve").pipe(
+      Flag.withDefault(false),
+      Flag.withDescription("Offer the approve tool, which ticks a retro report's approval marker")
+    ),
+    parallelRuns: Flag.Int("parallel-runs").pipe(
+      Flag.optional,
+      Flag.withDescription(
+        "Flows that write a checkout and may run at once per repository (default 1)"
+      )
+    )
+  },
+  (flags) =>
+    Effect.gen(function* () {
+      const config = yield* mcpOptionsFrom(flags, process.env, process.cwd(), nodeRead)
+      // SIGINT/SIGTERM interrupt the server; runMcp then stops the flows it started.
+      yield* runMcp(
+        config,
+        nodeOperatorRuntime(config, (cwd) => shellTierPaths({ cwd })),
+        process
+      )
+    })
+).pipe(
+  Command.withDescription(
+    "Serve llm4ts to an MCP client (Grok Bot, Claude Code, Cursor): status, diagnosis and, when allowed, runs (ADR 0041)"
+  )
+)
+
 const doctorCommand = Command.make("doctor", {}, () =>
   Effect.gen(function* () {
     const report = yield* makeDoctorProgram()
@@ -1014,6 +1074,7 @@ export const shellCommand = Command.make("llm4ts", {}, () =>
     graphCommand,
     rosterCommand,
     geminiBridgeCommand,
+    mcpCommand,
     doctorCommand
   ])
 )

package/src/FlowLaunch.ts

@@ -1,46 +1,9 @@
-import { spawn, spawnSync } from "node:child_process"
-import { existsSync } from "node:fs"
+import { spawnSync } from "node:child_process"
 import { constants } from "node:os"
-import { dirname, join, resolve } from "node:path"
-import { fileURLToPath } from "node:url"
 import * as Effect from "effect/Effect"
-import * as Schema from "effect/Schema"
+import { FlowLaunchError, needsResolveFallback, nodeFlowProcess } from "./FlowProcess.ts"
 
-export class FlowLaunchError extends Schema.TaggedError<FlowLaunchError>()("FlowLaunch", {
-  message: Schema.String
-}) {}
-
-/**
- * True when the flow script cannot resolve `@llm4ts/runner` from its own
- * location — a global flow, a built-in copy, or a bare repository. Project
- * flows inside a repository that installs `@llm4ts/*` resolve their own pin
- * and need no help (the project-wins policy of ADR 0006). Implemented as the
- * same `node_modules` directory walk ESM resolution performs, so the check
- * stays honest under test runners that patch the module system.
- */
-export const needsResolveFallback = (flowPath: string): boolean => {
-  let directory = dirname(resolve(flowPath))
-  while (true) {
-    if (existsSync(join(directory, "node_modules", "@llm4ts", "runner", "package.json"))) {
-      return false
-    }
-    const parent = dirname(directory)
-    if (parent === directory) {
-      return true
-    }
-    directory = parent
-  }
-}
-
-// In the published package the hook is the compiled sibling; when running
-// from src (tests), it is the TypeScript source, which the child can load
-// because it always runs with type stripping enabled.
-const resolveFallbackUrl = (() => {
-  const compiled = new URL("./ResolveFallback.js", import.meta.url)
-  return existsSync(fileURLToPath(compiled))
-    ? compiled.href
-    : new URL("./ResolveFallback.ts", import.meta.url).href
-})()
+export { FlowLaunchError, needsResolveFallback }
 
 export interface LaunchFlowOptions {
   readonly flowPath: string
@@ -76,40 +39,31 @@ const restoreTerminal = (stdio: "inherit" | "ignore"): void => {
  * the child's exit code (`128 + signal` when terminated by a signal).
  */
 export const launchFlow = (options: LaunchFlowOptions): Effect.Effect<number, FlowLaunchError> =>
-  Effect.callback<number, FlowLaunchError>((resume) => {
+  Effect.gen(function* () {
     const environment = { ...(options.environment ?? process.env) }
     if (options.coder !== undefined) {
       environment.LLM4TS_CODER = options.coder
     }
-    const nodeArgs = ["--experimental-strip-types"]
-    if (needsResolveFallback(options.flowPath)) {
-      nodeArgs.push("--import", resolveFallbackUrl)
-    }
-    const child = spawn(process.execPath, [...nodeArgs, options.flowPath, ...options.taskArgs], {
-      stdio: options.stdio ?? "inherit",
-      env: environment,
-      ...(options.cwd === undefined ? {} : { cwd: options.cwd })
-    })
+    const stdio = options.stdio ?? "inherit"
     const ignoreSigint = (): void => {}
     process.on("SIGINT", ignoreSigint)
     const restoreSigint = (): void => {
       process.removeListener("SIGINT", ignoreSigint)
     }
-    child.on("error", (error) => {
-      restoreSigint()
-      resume(Effect.fail(new FlowLaunchError({ message: error.message })))
-    })
-    child.on("exit", (code, signal) => {
-      restoreSigint()
-      restoreTerminal(options.stdio ?? "inherit")
-      if (signal !== null) {
-        resume(Effect.succeed(128 + (constants.signals[signal] ?? 15)))
-      } else {
-        resume(Effect.succeed(code ?? 1))
+    return yield* Effect.gen(function* () {
+      const handle = yield* nodeFlowProcess.start({
+        flowPath: options.flowPath,
+        args: options.taskArgs,
+        environment,
+        stdio,
+        ...(options.cwd === undefined ? {} : { cwd: options.cwd })
+      })
+      const exit = yield* handle.exited.pipe(Effect.onInterrupt(() => handle.signal("SIGINT")))
+      restoreTerminal(stdio)
+      if (exit.signal !== undefined) {
+        const number = Object.entries(constants.signals).find(([name]) => name === exit.signal)
+        return 128 + (number?.[1] ?? 15)
       }
-    })
-    return Effect.sync(() => {
-      restoreSigint()
-      child.kill("SIGINT")
-    })
+      return exit.code ?? 1
+    }).pipe(Effect.ensuring(Effect.sync(restoreSigint)))
   })