@llm4ts/shell 2.44.1 → 2.46.0

package/dist/OperatorActTools.js

@@ -0,0 +1,332 @@
+import * as Clock from "effect/Clock";
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import * as Tool from "effect/ai/Tool";
+import * as Toolkit from "effect/ai/Toolkit";
+import { approveMarkdown } from "@llm4ts/flow/Approval";
+import { PersistenceError } from "@llm4ts/flow/FlowError";
+import { InvalidKnob, NotAllowed, OperatorRun, ReadFailed, RunInProgress, RunWaitResult, UnknownEpic, UnknownFlow, UnknownRepo, UnknownRun } from "@llm4ts/flow/OperatorSchemas";
+import { retroApprovalOf, retroPaths } from "@llm4ts/flow/Retro";
+import { emptyTree } from "@llm4ts/runner/AgentTree";
+import { TraceUnreadable, foldTrace, meaningfulEventsAfter, runStatusOf } from "@llm4ts/runner/RunReaders";
+import { FlowLaunchError } from "./FlowProcess.js";
+import { resolveRepo } from "./OperatorTools.js";
+import { epicDirOf, epicOfRun, readEpicRunsStrict, readFailed, resolveRun, tracePending } from "./OperatorRuns.js";
+/**
+ * The operator's `run_wait` and act tools (`llm4ts mcp`, ADR 0041): waiting on
+ * a run without polling from the client, and starting, stopping, retro-ing and
+ * approving through the run supervisor. `run_wait` only reads, so it has its
+ * own toolkit the server registers beside the read tools; the act toolkit is
+ * registered only when the configuration allows runs or approvals.
+ */
+const repoParam = Schema.optional(Schema.String);
+// ---- run_wait -----------------------------------------------------------------------------
+export const runWaitTool = Tool.make("run_wait", {
+    description: "Wait for a run's next meaningful events after sinceSeq: returns as soon as one appears or the run is no longer running, else after timeoutSeconds (default 120, at most 300) with no events.",
+    parameters: Schema.Struct({
+        runId: Schema.String,
+        sinceSeq: Schema.optional(Schema.Int),
+        timeoutSeconds: Schema.optional(Schema.Int)
+    }),
+    success: RunWaitResult,
+    failure: Schema.Union([UnknownRun, TraceUnreadable, ReadFailed])
+})
+    .annotate(Tool.Readonly, true)
+    .annotate(Tool.Destructive, false);
+export const waitToolkit = Toolkit.make(runWaitTool);
+const pollInterval = "500 millis";
+const defaultWaitSeconds = 120;
+const maxWaitSeconds = 300;
+const isActive = (state) => state === "starting" || state === "running";
+const emptyFold = () => ({ lines: [], state: emptyTree(), seq: 0 });
+export const waitHandlers = (deps) => waitToolkit.of({
+    run_wait: ({ runId, sinceSeq, timeoutSeconds }) => Effect.gen(function* () {
+        const since = sinceSeq ?? 0;
+        const timeoutMs = Math.min(Math.max(0, timeoutSeconds ?? defaultWaitSeconds), maxWaitSeconds) * 1_000;
+        const run = yield* resolveRun(deps, runId);
+        const epic = yield* epicOfRun(deps, run);
+        const startedAt = yield* Clock.currentTimeMillis;
+        for (;;) {
+            const fold = (yield* tracePending(deps.files, run))
+                ? emptyFold()
+                : yield* foldTrace(deps.files, run.tracePath, epic?.dir);
+            // A supervised run's state is the supervisor's; a run found on disk ends with its trace.
+            const state = run.supervised === undefined
+                ? fold.lines.some((line) => line.kind === "RunEnded")
+                    ? "exited"
+                    : run.state
+                : ((yield* deps.supervisor.get(runId))?.state ?? run.state);
+            const events = meaningfulEventsAfter(fold.lines, since);
+            const exited = !isActive(state);
+            const elapsed = (yield* Clock.currentTimeMillis) - startedAt;
+            if (events.length > 0 || exited || elapsed >= timeoutMs) {
+                const status = runStatusOf(fold, { ...run, state }, yield* deps.now);
+                return RunWaitResult.make({
+                    events,
+                    seq: Math.max(fold.seq, since),
+                    ...(status.ended === undefined ? {} : { ended: status.ended }),
+                    exited,
+                    summary: status.summary
+                });
+            }
+            yield* Effect.sleep(pollInterval);
+        }
+    })
+});
+// ---- Act tools ----------------------------------------------------------------------------
+export const StartedRun = Schema.Struct({
+    runId: Schema.String,
+    tracePath: Schema.optionalKey(Schema.String),
+    pid: Schema.optionalKey(Schema.Int)
+});
+const startFailures = Schema.Union([
+    NotAllowed,
+    InvalidKnob,
+    UnknownRepo,
+    UnknownEpic,
+    UnknownRun,
+    UnknownFlow,
+    ReadFailed,
+    FlowLaunchError,
+    RunInProgress,
+    PersistenceError
+]);
+const StartRunParams = Schema.Struct({
+    repo: repoParam,
+    flow: Schema.String,
+    task: Schema.optional(Schema.String),
+    epic: Schema.optional(Schema.String),
+    pack: Schema.optional(Schema.String),
+    executors: Schema.optional(Schema.Array(Schema.String)),
+    coder: Schema.optional(Schema.String),
+    judgeRounds: Schema.optional(Schema.Int),
+    mergeRevisions: Schema.optional(Schema.Int),
+    land: Schema.optional(Schema.String),
+    flags: Schema.optional(Schema.Array(Schema.String)),
+    requestId: Schema.optional(Schema.String)
+});
+export const startRunTool = Tool.make("start_run", {
+    description: "Start a flow by name in the background with typed knobs; returns the run id at once. Repeating a call is safe only with the same requestId, which returns the run it already started; without one, every call starts a new run.",
+    parameters: StartRunParams,
+    success: StartedRun,
+    failure: startFailures
+}).annotate(Tool.Destructive, false);
+export const stopRunTool = Tool.make("stop_run", {
+    description: "Stop a run this server started: SIGINT, then SIGTERM after a grace period; returns its final record.",
+    parameters: Schema.Struct({ runId: Schema.String }),
+    success: OperatorRun,
+    failure: Schema.Union([NotAllowed, UnknownRun])
+}).annotate(Tool.Destructive, true);
+export const retroStartTool = Tool.make("retro_start", {
+    description: "Start epic-retro for an epic, optionally for one of its recorded runs; the retro report then waits for approve.",
+    parameters: Schema.Struct({
+        repo: repoParam,
+        epic: Schema.String,
+        run: Schema.optional(Schema.String)
+    }),
+    success: StartedRun,
+    failure: startFailures
+}).annotate(Tool.Destructive, false);
+export const approveTool = Tool.make("approve", {
+    description: "Approve a retro report: ticks its approval marker so the next epic run applies its fixes.",
+    parameters: Schema.Struct({
+        repo: repoParam,
+        kind: Schema.Literals(["retro"]),
+        epic: Schema.String,
+        id: Schema.String
+    }),
+    success: Schema.Struct({ path: Schema.String, approved: Schema.Boolean }),
+    failure: Schema.Union([
+        NotAllowed,
+        UnknownRepo,
+        UnknownEpic,
+        UnknownRun,
+        ReadFailed,
+        PersistenceError
+    ])
+}).annotate(Tool.Destructive, false);
+export const actToolkit = Toolkit.make(startRunTool, stopRunTool, retroStartTool, approveTool);
+const knobsOf = (params) => ({
+    ...(params.task === undefined ? {} : { task: params.task }),
+    ...(params.epic === undefined ? {} : { epic: params.epic }),
+    ...(params.pack === undefined ? {} : { pack: params.pack }),
+    ...(params.executors === undefined ? {} : { executors: params.executors }),
+    ...(params.coder === undefined ? {} : { coder: params.coder }),
+    ...(params.judgeRounds === undefined ? {} : { judgeRounds: params.judgeRounds }),
+    ...(params.mergeRevisions === undefined ? {} : { mergeRevisions: params.mergeRevisions }),
+    ...(params.land === undefined ? {} : { land: params.land }),
+    ...(params.flags === undefined ? {} : { flags: params.flags }),
+    ...(params.requestId === undefined ? {} : { requestId: params.requestId })
+});
+const namePattern = /^[A-Za-z0-9][A-Za-z0-9._-]*$/u;
+const packPattern = /^[\w.-]+(\/[\w.-]+)?$/u;
+const branchPattern = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/u;
+const flagPattern = /^--[a-z][a-z0-9-]*(=[A-Za-z0-9][A-Za-z0-9._/-]*)?$/u;
+const flagValuePattern = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/u;
+/**
+ * Flags a client may never pass through `flags`, with or without `=value`.
+ * `-C` already fails the shape pattern; it is named so a looser pattern
+ * cannot reopen it.
+ */
+const reservedFlags = [
+    // Points the flow at another directory (`FlowArgs.ts`).
+    "--repo",
+    // Alias of --repo in the flow argument parser.
+    "-C",
+    // Reads the prompt from any file on the server.
+    "--prompt-file",
+    // Typed knob: epic.
+    "--epic",
+    // Typed knob: land.
+    "--land",
+    // Typed knob: judgeRounds.
+    "--judge-rounds",
+    // Typed knob: mergeRevisions.
+    "--merge-revisions",
+    // Lets soap flows send mutating calls to a real ESB.
+    "--allow-mutating",
+    // Auto-confirms prompts a human is meant to answer.
+    "--yes",
+    // Selects which environment's credentials a flow uses.
+    "--env",
+    // A filesystem path in epic-design.
+    "--target"
+];
+const reservedFlagOf = (entry) => reservedFlags.find((flag) => entry === flag || entry.startsWith(`${flag}=`));
+/** Why a flags list is refused, or undefined when every entry has a safe shape. */
+const flagsProblem = (flags) => {
+    let previousWasFlag = false;
+    for (const entry of flags) {
+        const reserved = reservedFlagOf(entry);
+        if (reserved !== undefined)
+            return `${reserved} may not be passed through flags`;
+        const flag = flagPattern.exec(entry);
+        if (flag !== null) {
+            previousWasFlag = flag[1] === undefined;
+            continue;
+        }
+        if (!previousWasFlag || !flagValuePattern.test(entry)) {
+            return "every entry must be a --flag[=value] or a plain value right after a flag";
+        }
+        previousWasFlag = false;
+    }
+    return undefined;
+};
+const invalid = (knob, message) => Effect.fail(InvalidKnob.make({ knob, message }));
+/**
+ * Every client value that reaches the flow's argv or environment, checked
+ * before the supervisor sees it. Names stay names, never paths or flags:
+ * `pack` is a kit or kit/pack name (no `.`/`..` segment), `epic`, `coder` and
+ * executors are ids, `land` is a branch name. `task` is the flow's first
+ * positional argument, so it may not start with `-` (it would parse as a
+ * flag) or `@` (the flow parser reads `@<path>` as a prompt file on the
+ * server). `flags` is an allowlist of shapes: `--flag[=value]`, or a plain
+ * value right after a flag, never a reserved flag (`reservedFlags`).
+ */
+export const validateKnobs = (knobs) => {
+    if (knobs.pack !== undefined &&
+        (!packPattern.test(knobs.pack) ||
+            knobs.pack.split("/").some((segment) => segment === "." || segment === ".."))) {
+        return invalid("pack", "pack must be a kit or kit/pack name, not a path");
+    }
+    if (knobs.epic !== undefined && !namePattern.test(knobs.epic)) {
+        return invalid("epic", "epic must be an epic id");
+    }
+    if (knobs.coder !== undefined && !namePattern.test(knobs.coder)) {
+        return invalid("coder", "coder must be an executor or connector id");
+    }
+    if (knobs.executors?.some((id) => !namePattern.test(id)) === true) {
+        return invalid("executors", "every executor must be an executor id");
+    }
+    if (knobs.land !== undefined && !branchPattern.test(knobs.land)) {
+        return invalid("land", "land must be a branch name");
+    }
+    const nonNegative = (value) => value === undefined || (Number.isInteger(value) && value >= 0);
+    if (!nonNegative(knobs.judgeRounds)) {
+        return invalid("judgeRounds", "judgeRounds must be an integer of 0 or more");
+    }
+    if (!nonNegative(knobs.mergeRevisions)) {
+        return invalid("mergeRevisions", "mergeRevisions must be an integer of 0 or more");
+    }
+    if (knobs.task !== undefined && (knobs.task.startsWith("-") || knobs.task.startsWith("@"))) {
+        return invalid("task", "task must not start with '-' or '@'");
+    }
+    const problem = knobs.flags === undefined ? undefined : flagsProblem(knobs.flags);
+    if (problem !== undefined)
+        return invalid("flags", problem);
+    return Effect.succeed(knobs);
+};
+/** A run or retro id names one file, never a path. */
+const isPlainId = (id) => /^[\w.-]+$/u.test(id) && id !== "." && id !== "..";
+export const actHandlers = (deps) => {
+    const requireRun = deps.config.allowRun
+        ? Effect.void
+        : Effect.fail(NotAllowed.make({ message: "this server was not started with --allow-run" }));
+    const requireApprove = deps.config.allowApprove
+        ? Effect.void
+        : Effect.fail(NotAllowed.make({ message: "this server was not started with --allow-approve" }));
+    const startFlow = (repo, name, knobs) => Effect.gen(function* () {
+        const flows = yield* deps.flows(repo.path).pipe(Effect.mapError(readFailed));
+        const flow = flows.find((candidate) => candidate.name === name);
+        if (flow === undefined) {
+            return yield* UnknownFlow.make({
+                message: `unknown flow '${name}' in ${repo.id}: list_flows names the flows it can start`
+            });
+        }
+        const run = yield* deps.supervisor.start({
+            repo,
+            flow: { name: flow.name, path: flow.path },
+            knobs,
+            baseEnvironment: deps.environment
+        });
+        return {
+            runId: run.runId,
+            ...(run.tracePath === undefined ? {} : { tracePath: run.tracePath }),
+            ...(run.pid === undefined ? {} : { pid: run.pid })
+        };
+    });
+    return actToolkit.of({
+        start_run: (params) => Effect.gen(function* () {
+            yield* requireRun;
+            const repo = yield* resolveRepo(deps.config, params.repo);
+            const knobs = yield* validateKnobs(knobsOf(params));
+            return yield* startFlow(repo, params.flow, knobs);
+        }),
+        stop_run: ({ runId }) => Effect.andThen(requireRun, deps.supervisor.stop(runId)),
+        retro_start: ({ repo: repoId, epic, run }) => Effect.gen(function* () {
+            yield* requireRun;
+            const repo = yield* resolveRepo(deps.config, repoId);
+            const dir = yield* epicDirOf(deps, repo, epic);
+            if (run !== undefined) {
+                const recorded = yield* readEpicRunsStrict(deps.files, dir);
+                if (!recorded.some((entry) => entry.runId === run)) {
+                    return yield* UnknownRun.make({
+                        message: `epic '${epic}' has no recorded run '${run}'`
+                    });
+                }
+            }
+            // The client's values, checked like start_run's; the --epic flag itself is ours.
+            yield* validateKnobs({ epic, ...(run === undefined ? {} : { flags: ["--run", run] }) });
+            return yield* startFlow(repo, "epic-retro", {
+                flags: ["--epic", epic, ...(run === undefined ? [] : ["--run", run])]
+            });
+        }),
+        approve: ({ repo: repoId, epic, id }) => Effect.gen(function* () {
+            yield* requireApprove;
+            const repo = yield* resolveRepo(deps.config, repoId);
+            const dir = yield* epicDirOf(deps, repo, epic);
+            const unknown = UnknownRun.make({ message: `no retro '${id}' for epic '${epic}'` });
+            if (!isPlainId(id))
+                return yield* unknown;
+            const path = retroPaths(dir, id).report;
+            const markdown = yield* deps.files.read(path).pipe(Effect.mapError(readFailed));
+            if (markdown === undefined)
+                return yield* unknown;
+            const approved = approveMarkdown(markdown);
+            if (approved !== markdown)
+                yield* deps.files.writeAtomic(path, approved);
+            return { path, approved: retroApprovalOf(approved).approved };
+        })
+    });
+};
+//# sourceMappingURL=OperatorActTools.js.map

package/dist/OperatorActTools.js.map

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

package/dist/OperatorConfig.d.ts

@@ -0,0 +1,44 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { ShellUsageError } from "./ShellErrors.ts";
+export interface McpFlags {
+    readonly stdio: boolean;
+    readonly http: boolean;
+    readonly host: Option.Option<string>;
+    readonly port: Option.Option<number>;
+    readonly tokenFile: Option.Option<string>;
+    readonly repo: ReadonlyArray<string>;
+    readonly allowRun: boolean;
+    readonly allowApprove: boolean;
+    readonly parallelRuns: Option.Option<number>;
+}
+export interface OperatorConfig {
+    readonly transport: {
+        readonly _tag: "stdio";
+    } | {
+        readonly _tag: "http";
+        readonly host: string;
+        readonly port: number;
+        readonly token: string;
+    };
+    readonly repos: ReadonlyArray<{
+        readonly id: string;
+        readonly path: string;
+    }>;
+    readonly allowRun: boolean;
+    readonly allowApprove: boolean;
+    readonly parallelRuns: number;
+}
+export declare const McpConfigFile: Schema.Struct<{
+    readonly repos: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly path: Schema.String;
+    }>>;
+}>;
+/**
+ * Turns the `mcp` flags into the operator configuration. The token is read from the
+ * environment or a file and is never echoed in an error message.
+ */
+export declare const mcpOptionsFrom: (flags: McpFlags, environment: Readonly<Record<string, string | undefined>>, cwd: string, readFile: (path: string) => Effect.Effect<string | undefined>) => Effect.Effect<OperatorConfig, ShellUsageError>;
+//# sourceMappingURL=OperatorConfig.d.ts.map

package/dist/OperatorConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperatorConfig.d.ts","sourceRoot":"","sources":["../src/OperatorConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACzC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EACd;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;KAAE,GAC1B;QACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KACvB,CAAA;IACL,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC7E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAC9B;AAED,eAAO,MAAM,aAAa;;;;;EAExB,CAAA;AAOF;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,QAAQ,EACf,aAAa,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACzD,KAAK,MAAM,EACX,UAAU,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,KAC5D,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,CA4B5C,CAAA"}

package/dist/OperatorConfig.js

@@ -0,0 +1,88 @@
+import { homedir } from "node:os";
+import { basename, join, resolve } from "node:path";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import { ShellUsageError } from "./ShellErrors.js";
+export const McpConfigFile = Schema.Struct({
+    repos: Schema.Array(Schema.Struct({ id: Schema.String, path: Schema.String }))
+});
+/** The same name shape as an epic id: it names the repository's state directory. */
+const repoIdPattern = /^[A-Za-z0-9][A-Za-z0-9._-]*$/u;
+const usage = (message) => new ShellUsageError({ message });
+/**
+ * Turns the `mcp` flags into the operator configuration. The token is read from the
+ * environment or a file and is never echoed in an error message.
+ */
+export const mcpOptionsFrom = (flags, environment, cwd, readFile) => Effect.gen(function* () {
+    if (flags.stdio && flags.http) {
+        return yield* usage("mcp takes either --stdio or --http, not both");
+    }
+    const parallelRuns = Option.getOrElse(flags.parallelRuns, () => 1);
+    if (!Number.isInteger(parallelRuns) || parallelRuns < 1) {
+        return yield* usage("--parallel-runs must be a positive integer");
+    }
+    const transport = flags.http ? yield* httpTransport(flags, environment, cwd, readFile) : stdio;
+    const repos = yield* reposFrom(flags, environment, cwd, readFile);
+    const seen = new Set();
+    for (const repo of repos) {
+        if (seen.has(repo.id)) {
+            return yield* usage(`mcp repository id "${repo.id}" is used twice`);
+        }
+        seen.add(repo.id);
+    }
+    return {
+        transport,
+        repos,
+        allowRun: flags.allowRun,
+        allowApprove: flags.allowApprove,
+        parallelRuns
+    };
+});
+const stdio = { _tag: "stdio" };
+const httpTransport = (flags, environment, cwd, readFile) => Effect.gen(function* () {
+    const fromEnvironment = environment.LLM4TS_MCP_TOKEN?.trim() ?? "";
+    const fromFile = fromEnvironment.length === 0 && Option.isSome(flags.tokenFile)
+        ? ((yield* readFile(resolve(cwd, flags.tokenFile.value)))?.trim() ?? "")
+        : "";
+    const token = fromEnvironment.length > 0 ? fromEnvironment : fromFile;
+    if (token.length === 0) {
+        return yield* usage("--http needs a token: LLM4TS_MCP_TOKEN or --token-file");
+    }
+    const port = Option.getOrElse(flags.port, () => 4321);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        return yield* usage("--port must be between 0 and 65535");
+    }
+    return {
+        _tag: "http",
+        host: Option.getOrElse(flags.host, () => "127.0.0.1"),
+        port,
+        token
+    };
+});
+const reposFrom = (flags, environment, cwd, readFile) => Effect.gen(function* () {
+    if (flags.repo.length > 0) {
+        return flags.repo.map((path) => {
+            const absolute = resolve(cwd, path);
+            return { id: basename(absolute), path: absolute };
+        });
+    }
+    const configHome = environment.XDG_CONFIG_HOME !== undefined && environment.XDG_CONFIG_HOME.length > 0
+        ? environment.XDG_CONFIG_HOME
+        : join(environment.HOME ?? homedir(), ".config");
+    const configPath = join(configHome, "llm4ts", "mcp.json");
+    const raw = yield* readFile(configPath);
+    if (raw === undefined) {
+        return yield* usage("mcp needs --repo <path> or ~/.config/llm4ts/mcp.json");
+    }
+    const file = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(McpConfigFile))(raw).pipe(Effect.mapError(() => usage(`${configPath} is not a valid mcp config`)));
+    if (file.repos.length === 0) {
+        return yield* usage("mcp needs --repo <path> or ~/.config/llm4ts/mcp.json");
+    }
+    const badId = file.repos.find(({ id }) => !repoIdPattern.test(id));
+    if (badId !== undefined) {
+        return yield* usage(`${configPath}: repository id "${badId.id}" must match ${repoIdPattern.source}`);
+    }
+    return file.repos.map(({ id, path }) => ({ id, path: resolve(cwd, path) }));
+});
+//# sourceMappingURL=OperatorConfig.js.map

package/dist/OperatorConfig.js.map

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

package/dist/OperatorNode.d.ts

@@ -0,0 +1,45 @@
+import type * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import type { ServeError } from "effect/http/HttpServerError";
+import type { PersistenceError } from "@llm4ts/flow/FlowError";
+import { type SignalSource } from "@llm4ts/runner/FlowRunner";
+import { type FlowTierPaths } from "./FlowCatalog.ts";
+import { type FlowProcessShape } from "./FlowProcess.ts";
+import type { OperatorConfig } from "./OperatorConfig.ts";
+import type { OperatorDeps } from "./OperatorTools.ts";
+/**
+ * The Node side of `llm4ts mcp` (ADR 0041): the operator's dependencies over
+ * the real file system and processes, and `runMcp`, which serves until the
+ * server fails or a SIGINT/SIGTERM interrupts it, then stops the flows it
+ * started before returning.
+ */
+/** Everything `runMcp` needs besides the run supervisor, which it builds itself. */
+export interface McpRuntime<E> {
+    readonly operator: Omit<OperatorDeps, "supervisor">;
+    readonly flowProcess: FlowProcessShape;
+    /** The server; `runOperatorServer` on Node, a stand-in in tests. */
+    readonly serve: (config: OperatorConfig, deps: OperatorDeps) => Effect.Effect<never, E>;
+    /** How long stopping a run waits after SIGINT before SIGTERM; the supervisor's default when absent. */
+    readonly graceMs?: number;
+}
+/**
+ * Serves the operator until the server ends or a signal arrives. The first
+ * SIGINT or SIGTERM interrupts the server; closing the scope then runs the
+ * supervisor's finalizer, which stops every flow it started. A second signal
+ * exits at once (130 or 143). The handlers are removed on the way out.
+ */
+export declare const runMcp: <E>(config: OperatorConfig, runtime: McpRuntime<E>, signals: SignalSource) => Effect.Effect<void, E | PersistenceError>;
+/** A file's text, or `undefined` when it cannot be read (the `mcp` config and token file). */
+export declare const nodeRead: (path: string) => Effect.Effect<string | undefined>;
+/**
+ * Relative paths of every regular file under a directory, recursively; never
+ * directory names, and none when the directory is absent or unreadable.
+ */
+export declare const nodeListFiles: (directory: string) => ReadonlyArray<string>;
+/**
+ * The operator's dependencies on Node. `tierPaths` gives the flow tiers for a
+ * repository (the CLI's `shellTierPaths`, passed in to keep this module free
+ * of the CLI).
+ */
+export declare const nodeOperatorRuntime: (config: OperatorConfig, tierPaths: (repoPath: string) => FlowTierPaths, environment?: Readonly<Record<string, string | undefined>>) => McpRuntime<ServeError | Cause.IllegalArgumentError>;
+//# sourceMappingURL=OperatorNode.d.ts.map

package/dist/OperatorNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperatorNode.d.ts","sourceRoot":"","sources":["../src/OperatorNode.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAE1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAI9D,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAIhF,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGtD;;;;;GAKG;AAEH,oFAAoF;AACpF,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;IACnD,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAA;IACtC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IACvF,uGAAuG;IACvG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EACtB,QAAQ,cAAc,EACtB,SAAS,UAAU,CAAC,CAAC,CAAC,EACtB,SAAS,YAAY,KACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,gBAAgB,CA0B1C,CAAA;AAED,8FAA8F;AAC9F,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,CAOpE,CAAA;AAEJ;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,KAAG,aAAa,CAAC,MAAM,CAwBrE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,cAAc,EACtB,WAAW,CAAC,QAAQ,EAAE,MAAM,KAAK,aAAa,EAC9C,cAAa,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,KACtE,UAAU,CAAC,UAAU,GAAG,KAAK,CAAC,oBAAoB,CAmBnD,CAAA"}