@llm4ts/shell 2.45.0 → 2.46.0

package/dist/FlowProcess.js

@@ -0,0 +1,175 @@
+import { spawn } from "node:child_process";
+import { closeSync, existsSync, mkdirSync, openSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Ref from "effect/Ref";
+import * as Schema from "effect/Schema";
+export class FlowLaunchError extends Schema.TaggedError()("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) => {
+    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 const flowNodeArgs = (flowPath) => [
+    "--experimental-strip-types",
+    ...(needsResolveFallback(flowPath) ? ["--import", resolveFallbackUrl] : [])
+];
+const openAppend = (path) => {
+    mkdirSync(dirname(path), { recursive: true });
+    return openSync(path, "a");
+};
+export const nodeFlowProcess = {
+    start: (options) => Effect.callback((resume) => {
+        const exited = Deferred.makeUnsafe();
+        const fds = [];
+        const closeAll = () => {
+            for (const fd of fds.splice(0)) {
+                try {
+                    closeSync(fd);
+                }
+                catch {
+                    // already closed
+                }
+            }
+        };
+        let stdio;
+        try {
+            if (typeof options.stdio === "string") {
+                stdio = options.stdio;
+            }
+            else {
+                const out = openAppend(options.stdio.stdout);
+                fds.push(out);
+                const err = openAppend(options.stdio.stderr);
+                fds.push(err);
+                stdio = ["ignore", out, err];
+            }
+        }
+        catch (error) {
+            closeAll();
+            resume(Effect.fail(new FlowLaunchError({ message: error instanceof Error ? error.message : String(error) })));
+            return Effect.void;
+        }
+        const child = spawn(process.execPath, [...flowNodeArgs(options.flowPath), options.flowPath, ...options.args], {
+            stdio,
+            env: { ...options.environment },
+            ...(options.detached === true ? { detached: true } : {}),
+            ...(options.cwd === undefined ? {} : { cwd: options.cwd })
+        });
+        closeAll();
+        let started = false;
+        child.on("error", (error) => {
+            if (!started) {
+                resume(Effect.fail(new FlowLaunchError({ message: error.message })));
+            }
+        });
+        child.on("spawn", () => {
+            started = true;
+            resume(Effect.succeed({
+                pid: child.pid ?? 0,
+                exited: Deferred.await(exited),
+                signal: (signal) => Effect.sync(() => {
+                    child.kill(signal);
+                })
+            }));
+        });
+        child.on("exit", (code, signal) => {
+            Deferred.doneUnsafe(exited, Effect.succeed({ code: code ?? undefined, signal: signal ?? undefined }));
+        });
+        return Effect.void;
+    }),
+    isAlive: (pid) => {
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    signal: (pid, signal) => Effect.sync(() => {
+        try {
+            process.kill(pid, signal);
+        }
+        catch {
+            // already gone (ESRCH) or not ours to signal
+        }
+    })
+};
+export const makeFakeFlowProcess = () => Effect.gen(function* () {
+    const starts = yield* Ref.make([]);
+    const signals = yield* Ref.make([]);
+    const alive = yield* Ref.make(new Set());
+    const exits = new Map();
+    let nextPid = 1000;
+    const setMember = (pid, member) => Ref.update(alive, (set) => {
+        const next = new Set(set);
+        if (member) {
+            next.add(pid);
+        }
+        else {
+            next.delete(pid);
+        }
+        return next;
+    });
+    const process = {
+        start: (options) => Effect.gen(function* () {
+            const pid = nextPid++;
+            const exited = yield* Deferred.make();
+            exits.set(pid, exited);
+            yield* Ref.update(starts, (all) => [...all, options]);
+            yield* setMember(pid, true);
+            return {
+                pid,
+                exited: Deferred.await(exited),
+                signal: (signal) => Ref.update(signals, (all) => [...all, { pid, signal }])
+            };
+        }),
+        isAlive: (pid) => Ref.getUnsafe(alive).has(pid),
+        signal: (pid, signal) => Ref.update(signals, (all) => [...all, { pid, signal }])
+    };
+    return {
+        process,
+        started: Ref.get(starts),
+        signals: Ref.get(signals),
+        exit: (pid, exit) => Effect.gen(function* () {
+            yield* setMember(pid, false);
+            const deferred = exits.get(pid);
+            if (deferred !== undefined) {
+                yield* Deferred.succeed(deferred, exit);
+            }
+        }),
+        setAlive: (pid, value) => setMember(pid, value)
+    };
+});
+//# sourceMappingURL=FlowProcess.js.map

package/dist/FlowProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlowProcess.js","sourceRoot":"","sources":["../src/FlowProcess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACpE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAA;AACjC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,MAAM,OAAO,eAAgB,SAAQ,MAAM,CAAC,WAAW,EAAmB,CAAC,YAAY,EAAE;IACvF,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC;CAAG;AAEL;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAgB,EAAW,EAAE;IAChE,IAAI,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC1C,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YACrF,OAAO,KAAK,CAAA;QACd,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;QACjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,IAAI,CAAA;QACb,CAAC;QACD,SAAS,GAAG,MAAM,CAAA;IACpB,CAAC;AACH,CAAC,CAAA;AAED,0EAA0E;AAC1E,0EAA0E;AAC1E,sDAAsD;AACtD,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE;IAC/B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjE,OAAO,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC,CAAC,QAAQ,CAAC,IAAI;QACf,CAAC,CAAC,IAAI,GAAG,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAA;AAC3D,CAAC,CAAC,EAAE,CAAA;AAuCJ,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAyB,EAAE,CAAC;IACvE,4BAA4B;IAC5B,GAAG,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;CAC5E,CAAA;AAED,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE;IAC1C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,OAAO,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;AAC5B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,MAAM,CAAC,QAAQ,CAAqC,CAAC,MAAM,EAAE,EAAE;QAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,EAAmB,CAAA;QACrD,MAAM,GAAG,GAAkB,EAAE,CAAA;QAC7B,MAAM,QAAQ,GAAG,GAAS,EAAE;YAC1B,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,SAAS,CAAC,EAAE,CAAC,CAAA;gBACf,CAAC;gBAAC,MAAM,CAAC;oBACP,iBAAiB;gBACnB,CAAC;YACH,CAAC;QACH,CAAC,CAAA;QACD,IAAI,KAAsD,CAAA;QAC1D,IAAI,CAAC;YACH,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACtC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;YACvB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBAC5C,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACb,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBAC5C,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACb,KAAK,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;YAC9B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,EAAE,CAAA;YACV,MAAM,CACJ,MAAM,CAAC,IAAI,CACT,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CACzF,CACF,CAAA;YACD,OAAO,MAAM,CAAC,IAAI,CAAA;QACpB,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CACjB,OAAO,CAAC,QAAQ,EAChB,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,EACtE;YACE,KAAK;YACL,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE;YAC/B,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SAC3D,CACF,CAAA;QACD,QAAQ,EAAE,CAAA;QACV,IAAI,OAAO,GAAG,KAAK,CAAA;QACnB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;YACtE,CAAC;QACH,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACrB,OAAO,GAAG,IAAI,CAAA;YACd,MAAM,CACJ,MAAM,CAAC,OAAO,CAAC;gBACb,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;gBACnB,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;gBAC9B,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CACjB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;oBACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBACpB,CAAC,CAAC;aACL,CAAC,CACH,CAAA;QACH,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAChC,QAAQ,CAAC,UAAU,CACjB,MAAM,EACN,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,EAAE,MAAM,IAAI,SAAS,EAAE,CAAC,CACzE,CAAA;QACH,CAAC,CAAC,CAAA;QACF,OAAO,MAAM,CAAC,IAAI,CAAA;IACpB,CAAC,CAAC;IACJ,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACf,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;YACpB,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IACD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CACtB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;IACH,CAAC,CAAC;CACL,CAAA;AAUD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAmC,EAAE,CACtE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAkC,EAAE,CAAC,CAAA;IACnE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAiD,EAAE,CAAC,CAAA;IACnF,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAsB,IAAI,GAAG,EAAE,CAAC,CAAA;IAC7D,MAAM,KAAK,GAAG,IAAI,GAAG,EAA8C,CAAA;IACnE,IAAI,OAAO,GAAG,IAAI,CAAA;IAClB,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,MAAe,EAAE,EAAE,CACjD,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QACzB,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACf,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAClB,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;IACJ,MAAM,OAAO,GAAqB;QAChC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CACjB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,GAAG,GAAG,OAAO,EAAE,CAAA;YACrB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAmB,CAAA;YACtD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;YACtB,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,CAAC,CAAC,CAAA;YACrD,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YAC3B,OAAO;gBACL,GAAG;gBACH,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;gBAC9B,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;aAC5E,CAAA;QACH,CAAC,CAAC;QACJ,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QAC/C,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;KACjF,CAAA;IACD,OAAO;QACL,OAAO;QACP,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;QACxB,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;QACzB,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAClB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC/B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;YACzC,CAAC;QACH,CAAC,CAAC;QACJ,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC;KAChD,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/Menu.d.ts

@@ -5,5 +5,5 @@ import { type FlowTierPaths } from "./FlowCatalog.ts";
  * The interactive main menu: run a flow, view a flow, exit. Ctrl-C inside a
  * prompt quits the menu cleanly rather than crashing the shell.
  */
-export declare const mainMenu: (tiers: FlowTierPaths) => Effect.Effect<void, import("./FlowLaunch.ts").FlowLaunchError, Prompt.Environment>;
+export declare const mainMenu: (tiers: FlowTierPaths) => Effect.Effect<void, import("./FlowProcess.ts").FlowLaunchError, Prompt.Environment>;
 //# sourceMappingURL=Menu.d.ts.map

package/dist/Menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Menu.d.ts","sourceRoot":"","sources":["../src/Menu.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEnC,OAAO,EAAsC,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAuFzF;;;GAGG;AACH,eAAO,MAAM,QAAQ,8GA0BnB,CAAA"}
+{"version":3,"file":"Menu.d.ts","sourceRoot":"","sources":["../src/Menu.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEnC,OAAO,EAAsC,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAuFzF;;;GAGG;AACH,eAAO,MAAM,QAAQ,+GA0BnB,CAAA"}

package/dist/OperatorActTools.d.ts

@@ -0,0 +1,170 @@
+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 { PersistenceError } from "@llm4ts/flow/FlowError";
+import { InvalidKnob, NotAllowed, OperatorRun, ReadFailed, RunInProgress, RunWaitResult, UnknownEpic, UnknownFlow, UnknownRepo, UnknownRun, type OperatorKnobs } from "@llm4ts/flow/OperatorSchemas";
+import { TraceUnreadable } from "@llm4ts/runner/RunReaders";
+import { FlowLaunchError } from "./FlowProcess.ts";
+import { type OperatorDeps } from "./OperatorTools.ts";
+export declare const runWaitTool: Tool.Tool<"run_wait", {
+    readonly parameters: Schema.Struct<{
+        readonly runId: Schema.String;
+        readonly sinceSeq: Schema.optional<Schema.Int>;
+        readonly timeoutSeconds: Schema.optional<Schema.Int>;
+    }>;
+    readonly success: typeof RunWaitResult;
+    readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof TraceUnreadable, typeof ReadFailed]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const waitToolkit: Toolkit.Toolkit<{
+    readonly run_wait: Tool.Tool<"run_wait", {
+        readonly parameters: Schema.Struct<{
+            readonly runId: Schema.String;
+            readonly sinceSeq: Schema.optional<Schema.Int>;
+            readonly timeoutSeconds: Schema.optional<Schema.Int>;
+        }>;
+        readonly success: typeof RunWaitResult;
+        readonly failure: Schema.Union<readonly [typeof UnknownRun, typeof TraceUnreadable, typeof ReadFailed]>;
+        readonly failureMode: "error";
+    }, never>;
+}>;
+export declare const waitHandlers: (deps: OperatorDeps) => Toolkit.HandlersFrom<Toolkit.Tools<typeof waitToolkit>>;
+export declare const StartedRun: Schema.Struct<{
+    readonly runId: Schema.String;
+    readonly tracePath: Schema.optionalKey<Schema.String>;
+    readonly pid: Schema.optionalKey<Schema.Int>;
+}>;
+export declare const startRunTool: Tool.Tool<"start_run", {
+    readonly parameters: Schema.Struct<{
+        readonly repo: Schema.optional<Schema.String>;
+        readonly flow: Schema.String;
+        readonly task: Schema.optional<Schema.String>;
+        readonly epic: Schema.optional<Schema.String>;
+        readonly pack: Schema.optional<Schema.String>;
+        readonly executors: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly coder: Schema.optional<Schema.String>;
+        readonly judgeRounds: Schema.optional<Schema.Int>;
+        readonly mergeRevisions: Schema.optional<Schema.Int>;
+        readonly land: Schema.optional<Schema.String>;
+        readonly flags: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly requestId: Schema.optional<Schema.String>;
+    }>;
+    readonly success: Schema.Struct<{
+        readonly runId: Schema.String;
+        readonly tracePath: Schema.optionalKey<Schema.String>;
+        readonly pid: Schema.optionalKey<Schema.Int>;
+    }>;
+    readonly failure: Schema.Union<readonly [typeof NotAllowed, typeof InvalidKnob, typeof UnknownRepo, typeof UnknownEpic, typeof UnknownRun, typeof UnknownFlow, typeof ReadFailed, typeof FlowLaunchError, typeof RunInProgress, typeof PersistenceError]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const stopRunTool: Tool.Tool<"stop_run", {
+    readonly parameters: Schema.Struct<{
+        readonly runId: Schema.String;
+    }>;
+    readonly success: typeof OperatorRun;
+    readonly failure: Schema.Union<readonly [typeof NotAllowed, typeof UnknownRun]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const retroStartTool: Tool.Tool<"retro_start", {
+    readonly parameters: Schema.Struct<{
+        readonly repo: Schema.optional<Schema.String>;
+        readonly epic: Schema.String;
+        readonly run: Schema.optional<Schema.String>;
+    }>;
+    readonly success: Schema.Struct<{
+        readonly runId: Schema.String;
+        readonly tracePath: Schema.optionalKey<Schema.String>;
+        readonly pid: Schema.optionalKey<Schema.Int>;
+    }>;
+    readonly failure: Schema.Union<readonly [typeof NotAllowed, typeof InvalidKnob, typeof UnknownRepo, typeof UnknownEpic, typeof UnknownRun, typeof UnknownFlow, typeof ReadFailed, typeof FlowLaunchError, typeof RunInProgress, typeof PersistenceError]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const approveTool: Tool.Tool<"approve", {
+    readonly parameters: Schema.Struct<{
+        readonly repo: Schema.optional<Schema.String>;
+        readonly kind: Schema.Literals<readonly ["retro"]>;
+        readonly epic: Schema.String;
+        readonly id: Schema.String;
+    }>;
+    readonly success: Schema.Struct<{
+        readonly path: Schema.String;
+        readonly approved: Schema.Boolean;
+    }>;
+    readonly failure: Schema.Union<readonly [typeof NotAllowed, typeof UnknownRepo, typeof UnknownEpic, typeof UnknownRun, typeof ReadFailed, typeof PersistenceError]>;
+    readonly failureMode: "error";
+}, never>;
+export declare const actToolkit: Toolkit.Toolkit<{
+    readonly start_run: Tool.Tool<"start_run", {
+        readonly parameters: Schema.Struct<{
+            readonly repo: Schema.optional<Schema.String>;
+            readonly flow: Schema.String;
+            readonly task: Schema.optional<Schema.String>;
+            readonly epic: Schema.optional<Schema.String>;
+            readonly pack: Schema.optional<Schema.String>;
+            readonly executors: Schema.optional<Schema.$Array<Schema.String>>;
+            readonly coder: Schema.optional<Schema.String>;
+            readonly judgeRounds: Schema.optional<Schema.Int>;
+            readonly mergeRevisions: Schema.optional<Schema.Int>;
+            readonly land: Schema.optional<Schema.String>;
+            readonly flags: Schema.optional<Schema.$Array<Schema.String>>;
+            readonly requestId: Schema.optional<Schema.String>;
+        }>;
+        readonly success: Schema.Struct<{
+            readonly runId: Schema.String;
+            readonly tracePath: Schema.optionalKey<Schema.String>;
+            readonly pid: Schema.optionalKey<Schema.Int>;
+        }>;
+        readonly failure: Schema.Union<readonly [typeof NotAllowed, typeof InvalidKnob, typeof UnknownRepo, typeof UnknownEpic, typeof UnknownRun, typeof UnknownFlow, typeof ReadFailed, typeof FlowLaunchError, typeof RunInProgress, typeof PersistenceError]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly stop_run: Tool.Tool<"stop_run", {
+        readonly parameters: Schema.Struct<{
+            readonly runId: Schema.String;
+        }>;
+        readonly success: typeof OperatorRun;
+        readonly failure: Schema.Union<readonly [typeof NotAllowed, typeof UnknownRun]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly retro_start: Tool.Tool<"retro_start", {
+        readonly parameters: Schema.Struct<{
+            readonly repo: Schema.optional<Schema.String>;
+            readonly epic: Schema.String;
+            readonly run: Schema.optional<Schema.String>;
+        }>;
+        readonly success: Schema.Struct<{
+            readonly runId: Schema.String;
+            readonly tracePath: Schema.optionalKey<Schema.String>;
+            readonly pid: Schema.optionalKey<Schema.Int>;
+        }>;
+        readonly failure: Schema.Union<readonly [typeof NotAllowed, typeof InvalidKnob, typeof UnknownRepo, typeof UnknownEpic, typeof UnknownRun, typeof UnknownFlow, typeof ReadFailed, typeof FlowLaunchError, typeof RunInProgress, typeof PersistenceError]>;
+        readonly failureMode: "error";
+    }, never>;
+    readonly approve: Tool.Tool<"approve", {
+        readonly parameters: Schema.Struct<{
+            readonly repo: Schema.optional<Schema.String>;
+            readonly kind: Schema.Literals<readonly ["retro"]>;
+            readonly epic: Schema.String;
+            readonly id: Schema.String;
+        }>;
+        readonly success: Schema.Struct<{
+            readonly path: Schema.String;
+            readonly approved: Schema.Boolean;
+        }>;
+        readonly failure: Schema.Union<readonly [typeof NotAllowed, typeof UnknownRepo, typeof UnknownEpic, typeof UnknownRun, typeof ReadFailed, typeof PersistenceError]>;
+        readonly failureMode: "error";
+    }, never>;
+}>;
+/**
+ * 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 declare const validateKnobs: (knobs: OperatorKnobs) => Effect.Effect<OperatorKnobs, InvalidKnob>;
+export declare const actHandlers: (deps: OperatorDeps) => Toolkit.HandlersFrom<Toolkit.Tools<typeof actToolkit>>;
+//# sourceMappingURL=OperatorActTools.d.ts.map

package/dist/OperatorActTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OperatorActTools.d.ts","sourceRoot":"","sources":["../src/OperatorActTools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAA;AACtC,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAA;AAE5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EACL,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,KAAK,aAAa,EAEnB,MAAM,8BAA8B,CAAA;AAGrC,OAAO,EACL,eAAe,EAKhB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAuBnE,eAAO,MAAM,WAAW;;;;;;;;;SAYY,CAAA;AAEpC,eAAO,MAAM,WAAW;;;;;;;;;;;EAA4B,CAAA;AAUpD,eAAO,MAAM,YAAY,GACvB,MAAM,YAAY,KACjB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAqCrD,CAAA;AAIJ,eAAO,MAAM,UAAU;;;;EAIrB,CAAA;AA8BF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;SAMW,CAAA;AAEpC,eAAO,MAAM,WAAW;;;;;;;SAMW,CAAA;AAEnC,eAAO,MAAM,cAAc;;;;;;;;;;;;;SAUS,CAAA;AAEpC,eAAO,MAAM,WAAW;;;;;;;;;;;;;SAkBY,CAAA;AAEpC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAuE,CAAA;AA4E9F;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,aAAa,KAAG,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,WAAW,CAkC5F,CAAA;AAKD,eAAO,MAAM,WAAW,GACtB,MAAM,YAAY,KACjB,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CA4EvD,CAAA"}