@wrenautomation/aerie 0.4.6 → 0.5.0

package/dist/run/adapters.d.ts

@@ -0,0 +1,42 @@
+import type { TaskRecord } from "../core/index.js";
+import type { RunEvent, Runner, RunnerName } from "./port.js";
+export interface AdapterOptions {
+    /** binary path; default the runner's own name on PATH */
+    bin?: string | undefined;
+    /** extra args before the prompt */
+    args?: string[] | undefined;
+}
+/** What every agent is told: the task whole, and how to ask a person. */
+export declare function promptOf(t: TaskRecord, answers?: string[]): string;
+type ClaudeItem = {
+    type: string;
+    text?: string;
+    name?: string;
+    input?: unknown;
+    content?: unknown;
+};
+type ClaudeLine = {
+    type: string;
+    subtype?: string;
+    session_id?: string;
+    message?: {
+        content?: ClaudeItem[];
+    };
+    result?: string;
+    is_error?: boolean;
+    total_cost_usd?: number;
+};
+/** headless default: file edits and the aerie CLI, no other shell */
+export declare const CLAUDE_TOOLS: string[];
+export declare function claudeEvent(l: ClaudeLine): RunEvent;
+export declare function claudeRunner(o?: AdapterOptions): Runner;
+export declare function codexRunner(o?: AdapterOptions): Runner;
+export declare function grokRunner(o?: AdapterOptions): Runner;
+export declare function autobrowseRunner(o?: AdapterOptions): Runner;
+export declare function apiRunner(o: {
+    spec: string;
+    env?: Record<string, string | undefined>;
+}): Runner;
+/** The headless runners from settings: `AERIE_<RUNNER>_BIN`, `AERIE_<RUNNER>_ARGS` (a JSON array), `AERIE_API_MODEL`. */
+export declare function headlessRunners(get: (k: string) => string | undefined): Map<RunnerName, Runner>;
+export {};

package/dist/run/adapters.js

@@ -0,0 +1,275 @@
+/**
+ * The five headless runners (design: Runners). Each line a child prints is one event, kept whole (`data`).
+ * codex and grok: no binary on the dev Mac yet, so their lines are kept raw and the summary is a best guess.
+ */
+import { z } from "zod";
+import { runLines } from "./spawn.js";
+/** What every agent is told: the task whole, and how to ask a person. */
+export function promptOf(t, answers = []) {
+    const checks = (title, cs) => cs.length
+        ? `\n${title}:\n${cs.map((c) => `- [${c.done ? "x" : " "}] ${c.text}`).join("\n")}`
+        : "";
+    return [
+        `Aerie task ${t.id} (area ${t.area}): ${t.title}`,
+        t.description ? `\n${t.description}` : "",
+        checks("Acceptance criteria", t.ac),
+        checks("Definition of done", t.dod),
+        t.plan ? `\nPlan:\n${t.plan}` : "",
+        t.notes ? `\nNotes:\n${t.notes}` : "",
+        answers.length
+            ? `\nDecisions already made for this task. Follow them; do not ask again:\n${answers.map((x) => `- ${x}`).join("\n")}`
+            : "",
+        "\nDo the task. End with a short summary of what you did; it becomes the task's final summary.",
+        `If a person must decide something first, run \`aerie ask "<question>" --option a=<text> --option b=<text> --blocks ${t.id}\` and stop.`,
+    ].join("\n");
+}
+const parse = (line) => {
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+};
+const tail = (s, n = 2000) => (s.length > n ? `…${s.slice(-n)}` : s);
+const failedRun = (r, what) => ({
+    outcome: "failed",
+    summary: r.aborted
+        ? `${what} stopped: the lease was lost or the worker stopped`
+        : `${what} exited ${r.code ?? r.killed}${r.stderr.trim() ? `: ${tail(r.stderr.trim(), 600)}` : ""}`,
+    data: { code: r.code, signal: r.killed, stderr: r.stderr },
+});
+/** headless default: file edits and the aerie CLI, no other shell */
+export const CLAUDE_TOOLS = ["Read", "Edit", "Write", "Glob", "Grep", "Bash(aerie *)"];
+const textOf = (c) => typeof c === "string"
+    ? c
+    : Array.isArray(c)
+        ? c.map((x) => x.text ?? "").join("")
+        : "";
+export function claudeEvent(l) {
+    if (l.type === "system")
+        return { kind: l.subtype === "init" ? "init" : "line", text: l.subtype, data: l };
+    const items = l.message?.content ?? [];
+    if (l.type === "assistant") {
+        const tool = items.find((i) => i.type === "tool_use");
+        if (tool)
+            return {
+                kind: "tool",
+                text: `${tool.name} ${JSON.stringify(tool.input)}`.slice(0, 500),
+                data: l,
+            };
+        return { kind: "say", text: items.map((i) => i.text ?? "").join(""), data: l };
+    }
+    if (l.type === "user" && items.some((i) => i.type === "tool_result"))
+        return {
+            kind: "tool-result",
+            text: items
+                .map((i) => textOf(i.content))
+                .join("\n")
+                .slice(0, 500),
+            data: l,
+        };
+    return { kind: "line", text: l.type, data: l };
+}
+export function claudeRunner(o = {}) {
+    return {
+        name: "claude",
+        async run(t, ctx) {
+            let last = null;
+            let session;
+            const args = [
+                "-p",
+                promptOf(t, ctx.answers),
+                "--output-format",
+                "stream-json",
+                "--verbose",
+                ...(ctx.model ? ["--model", ctx.model] : []),
+                ...(o.args ?? ["--allowedTools", ...CLAUDE_TOOLS]),
+            ];
+            const r = await runLines(o.bin ?? "claude", args, {
+                ...spawnOf(ctx),
+                onLine: async (line) => {
+                    const l = parse(line);
+                    if (!l)
+                        return ctx.emit({ kind: "line", text: line.slice(0, 500), data: line });
+                    session ??= l.session_id;
+                    if (l.type === "result") {
+                        last = l;
+                        return;
+                    }
+                    await ctx.emit(claudeEvent(l));
+                },
+            });
+            const res = last;
+            if (!res || r.aborted)
+                return { ...failedRun(r, "claude"), session };
+            const ok = res.subtype === "success" && !res.is_error;
+            return {
+                outcome: ok ? "done" : "failed",
+                summary: res.result?.trim() || res.subtype || "no result",
+                usd: res.total_cost_usd,
+                session,
+                data: res,
+            };
+        },
+    };
+}
+// ── codex: `exec --json`, JSON lines (shape unverified) ──
+/** the last string under a `text` or `message` key, depth first: codex's final message, as best we know */
+function lastText(v) {
+    if (!v || typeof v !== "object")
+        return null;
+    let hit = null;
+    for (const [k, x] of Object.entries(v)) {
+        if ((k === "text" || k === "message") && typeof x === "string" && x.trim())
+            hit = x;
+        else
+            hit = lastText(x) ?? hit;
+    }
+    return hit;
+}
+export function codexRunner(o = {}) {
+    return {
+        name: "codex",
+        async run(t, ctx) {
+            let summary = null;
+            const r = await runLines(o.bin ?? "codex", [
+                "exec",
+                "--json",
+                ...(ctx.model ? ["--model", ctx.model] : []),
+                ...(o.args ?? []),
+                promptOf(t, ctx.answers),
+            ], {
+                ...spawnOf(ctx),
+                onLine: async (line) => {
+                    const l = parse(line);
+                    summary = lastText(l) ?? summary;
+                    await ctx.emit({ kind: "line", text: line.slice(0, 500), data: l ?? line });
+                },
+            });
+            if (r.aborted || r.code !== 0)
+                return failedRun(r, "codex");
+            return { outcome: "done", summary: summary ?? "codex exited 0" };
+        },
+    };
+}
+// ── grok: `-p`, plain text (unverified) ──
+export function grokRunner(o = {}) {
+    return {
+        name: "grok",
+        async run(t, ctx) {
+            const out = [];
+            const r = await runLines(o.bin ?? "grok", [
+                ...(ctx.model ? ["--model", ctx.model] : []),
+                ...(o.args ?? []),
+                "-p",
+                promptOf(t, ctx.answers),
+            ], {
+                ...spawnOf(ctx),
+                onLine: async (line) => {
+                    out.push(line);
+                    await ctx.emit({ kind: "line", text: line.slice(0, 500), data: line });
+                },
+            });
+            if (r.aborted || r.code !== 0)
+                return failedRun(r, "grok");
+            return { outcome: "done", summary: tail(out.join("\n").trim()) || "grok exited 0" };
+        },
+    };
+}
+// ── autobrowse-do: the title is the goal; `extra.input` {k: v} become --input; first line `<status> via <via>: …` ──
+const DO_LINE = /^(done|needs-human|failed|planned) via (\S+)(?: (\S+))?: (.*)$/;
+export function autobrowseRunner(o = {}) {
+    return {
+        name: "autobrowse-do",
+        async run(t, ctx) {
+            const input = (t.extra.input ?? {});
+            const out = [];
+            let head = null;
+            const r = await runLines(o.bin ?? "autobrowse", [
+                "do",
+                ...Object.entries(input).flatMap(([k, v]) => ["--input", `${k}=${String(v)}`]),
+                ...(o.args ?? []),
+                t.title,
+            ], {
+                ...spawnOf(ctx),
+                onLine: async (line) => {
+                    out.push(line);
+                    head ??= DO_LINE.exec(line);
+                    await ctx.emit({ kind: "line", text: line.slice(0, 500), data: line });
+                },
+            });
+            const h = head;
+            if (r.aborted || !h)
+                return failedRun(r, "autobrowse do");
+            const status = h[1];
+            const summary = `${h[4]} (via ${h[2]}${h[3] ? ` ${h[3]}` : ""})`;
+            return {
+                // planned (--dry-run): nothing ran; the plan waits for a person's go
+                outcome: status === "done" ? "done" : status === "failed" ? "failed" : "needs-input",
+                summary,
+                ...(status === "planned" ? { question: `Run this plan for real? ${summary}` } : {}),
+                session: /^session (\S+)/m.exec(out.join("\n"))?.[1],
+                data: { status, via: h[2], name: h[3] ?? null, out: out.join("\n") },
+            };
+        },
+    };
+}
+// ── api: one `ask` through `models`; no tools ──
+const ApiAnswer = z.object({
+    outcome: z.enum(["done", "needs-input", "failed"]),
+    summary: z.string(),
+    question: z.string().optional(),
+});
+export function apiRunner(o) {
+    return {
+        name: "api",
+        async run(t, ctx) {
+            const { modelFromSpec } = await import("@wrenautomation/models/spec");
+            const spec = ctx.model ?? o.spec;
+            const m = modelFromSpec(spec, { ...process.env, ...o.env, ...ctx.env });
+            await ctx.emit({ kind: "init", text: m.id, data: { spec, model: m.id } });
+            try {
+                const { value, usage } = await m.ask(`${promptOf(t, ctx.answers)}\n\nYou have no tools. Answer as JSON: outcome (done, needs-input or failed), summary, and question when a person must decide.`, ApiAnswer);
+                await ctx.emit({ kind: "say", text: value.summary, data: { value, usage } });
+                return {
+                    outcome: value.outcome,
+                    summary: value.summary,
+                    question: value.question,
+                    usd: usage?.usd,
+                    data: { value, usage, model: m.id },
+                };
+            }
+            catch (e) {
+                return {
+                    outcome: "failed",
+                    summary: `${m.id}: ${e.message}`,
+                    data: { error: String(e) },
+                };
+            }
+        },
+    };
+}
+function spawnOf(ctx) {
+    return { cwd: ctx.cwd, env: ctx.env, signal: ctx.signal };
+}
+/** The headless runners from settings: `AERIE_<RUNNER>_BIN`, `AERIE_<RUNNER>_ARGS` (a JSON array), `AERIE_API_MODEL`. */
+export function headlessRunners(get) {
+    const opt = (name) => {
+        const key = name.toUpperCase().replace(/-/g, "_");
+        const args = get(`AERIE_${key}_ARGS`);
+        return {
+            bin: get(`AERIE_${key}_BIN`),
+            args: args ? JSON.parse(args) : undefined,
+        };
+    };
+    const rs = [
+        claudeRunner(opt("claude")),
+        codexRunner(opt("codex")),
+        grokRunner(opt("grok")),
+        autobrowseRunner(opt("autobrowse")),
+        apiRunner({ spec: get("AERIE_API_MODEL") ?? "openrouter" }),
+    ];
+    return new Map(rs.map((r) => [r.name, r]));
+}
+//# sourceMappingURL=adapters.js.map

package/dist/run/adapters.js.map

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

package/dist/run/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./adapters.js";
+export * from "./port.js";
+export * from "./route.js";
+export * from "./worker.js";

package/dist/run/index.js

@@ -0,0 +1,5 @@
+export * from "./adapters.js";
+export * from "./port.js";
+export * from "./route.js";
+export * from "./worker.js";
+//# sourceMappingURL=index.js.map

package/dist/run/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/run/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/run/port.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The runner port (design: Runners, D18). Every runner names its lane; the five headless ones also run.
+ * A session runner has no `run`: the route puts the task on a session lane and that session takes it.
+ */
+import type { TaskRecord } from "../core/index.js";
+export declare const RUNNERS: readonly ["claude", "codex", "grok", "api", "autobrowse-do", "session"];
+export type RunnerName = (typeof RUNNERS)[number];
+/** where a routed task waits */
+export declare const runLane: (r: RunnerName) => string;
+export interface Route {
+    runner: RunnerName;
+    /** a model id or spec the runner takes; null = its default */
+    model: string | null;
+    /** session runners: the session lane; headless: `run:<runner>` */
+    lane: string;
+    why: string;
+    /** the rule's id, or null when the small model picked */
+    rule: number | null;
+    by: string;
+}
+/** One row of `task_event` per item: a message, a tool call, a tool result. `data` is the source line, whole. */
+export interface RunEvent {
+    kind: "init" | "say" | "tool" | "tool-result" | "line" | "stderr";
+    text?: string | undefined;
+    data?: unknown | undefined;
+}
+export interface RunResult {
+    outcome: "done" | "failed" | "needs-input";
+    summary: string;
+    /** needs-input from a runner with no shell (api): the worker files it as a decision */
+    question?: string | undefined;
+    usd?: number | undefined;
+    /** the vendor's session or run id, so a person can resume it */
+    session?: string | undefined;
+    data?: unknown | undefined;
+}
+export interface RunContext {
+    /** the routed model, or null */
+    model: string | null;
+    /** answered decisions on this task, one line each: the prompt says to follow them */
+    answers?: string[] | undefined;
+    /** the scratch folder the child runs in */
+    cwd: string;
+    /** env for the child: AERIE_TASK and the like, on top of process.env */
+    env: Record<string, string>;
+    /** aborted when the lease is lost or the worker stops: the child's process group is killed */
+    signal: AbortSignal;
+    emit(e: RunEvent): Promise<void>;
+}
+export interface Runner {
+    name: RunnerName;
+    /** headless only; a run settles, never throws for the child's own failure */
+    run?(task: TaskRecord, ctx: RunContext): Promise<RunResult>;
+}

package/dist/run/port.js

@@ -0,0 +1,4 @@
+export const RUNNERS = ["claude", "codex", "grok", "api", "autobrowse-do", "session"];
+/** where a routed task waits */
+export const runLane = (r) => `run:${r}`;
+//# sourceMappingURL=port.js.map

package/dist/run/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../src/run/port.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,CAAU,CAAC;AAG/F,gCAAgC;AAChC,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC"}

package/dist/run/route.d.ts

@@ -0,0 +1,41 @@
+import type { CoordStore } from "../coord/port.js";
+import { type TaskRecord } from "../core/index.js";
+import type { AerieStore } from "../store.js";
+import { type Route, type RunnerName } from "./port.js";
+/** what each runner is for: the picker reads it */
+export declare const RUNNER_USE: Record<RunnerName, string>;
+export type RunnerPick = {
+    runner: RunnerName;
+    model: string | null;
+    why: string;
+};
+/** the small model's choice; tests pass a fake */
+export type Picker = (t: TaskRecord) => Promise<RunnerPick & {
+    by: string;
+}>;
+/** the picker on a `models` spec (setting `router_model`) */
+export declare function modelPicker(spec: string, env?: Record<string, string | undefined>): Picker;
+/** the route only; nothing written */
+export declare function routeOf(a: AerieStore, t: TaskRecord, pick?: Picker): Promise<Route>;
+/** headless: pinned to its lane, so a session serving every lane (`*`) never takes it */
+export declare const queueSpot: (r: Pick<Route, "runner" | "lane">) => {
+    lane: string;
+    pin?: never;
+} | {
+    lane: string;
+    pin: string;
+};
+/** route, log, queue; the task's own lane already holding it is fine (queueAdd moves it) */
+export declare function route(a: AerieStore, coord: CoordStore, id: string, by: string, pick?: Picker): Promise<Route>;
+/**
+ * After a decision on a task a runner had: back on a lane, or not. Answer `william`: assigned to him, off the queue.
+ * `session`: the session lane of its area. Else (`retry`, or words for an agent that asked): routed again.
+ */
+export declare function afterDecision(a: AerieStore, coord: CoordStore, d: {
+    id: number;
+    answer?: string | null | undefined;
+    blocks: string[];
+}, by: string, pick?: Picker): Promise<{
+    id: string;
+    lane: string | null;
+}[]>;

package/dist/run/route.js

@@ -0,0 +1,110 @@
+/**
+ * Route at queue time (D18): the first rule in rank order whose Filter matches wins; no match → the small model
+ * (setting `router_model`) picks with a why. One `routed` event, then the task goes on its lane.
+ */
+import { z } from "zod";
+import { matches } from "../core/index.js";
+import { AerieError } from "../db.js";
+import { RUNNERS, runLane } from "./port.js";
+/** what each runner is for: the picker reads it */
+export const RUNNER_USE = {
+    claude: "code and file work in a repo; shell limited to the aerie CLI",
+    codex: "code work, OpenAI's agent",
+    grok: "code and research, xAI's agent",
+    api: "writing, sorting and short answers; no tools, no files",
+    "autobrowse-do": "a chore on a website: the task title is the goal",
+    session: "long or judgment-heavy work a live Claude Code session should own",
+};
+const PickAnswer = z.object({
+    runner: z.enum(RUNNERS),
+    why: z.string().min(1),
+});
+/** the picker on a `models` spec (setting `router_model`) */
+export function modelPicker(spec, env = process.env) {
+    return async (t) => {
+        const { modelFromSpec } = await import("@wrenautomation/models/spec");
+        const m = modelFromSpec(spec, env);
+        const list = RUNNERS.map((r) => `- ${r}: ${RUNNER_USE[r]}`).join("\n");
+        const { value } = await m.ask([
+            "Pick the runner for this task. Runners:",
+            list,
+            "",
+            `Task ${t.id} (area ${t.area}, labels ${t.labels.join(", ") || "none"}): ${t.title}`,
+            t.description ? t.description.slice(0, 2000) : "",
+            "",
+            "Answer as JSON: runner, and why in one short sentence.",
+        ].join("\n"), PickAnswer);
+        return { runner: value.runner, model: null, why: value.why, by: `agent:${m.id}` };
+    };
+}
+/** the route only; nothing written */
+export async function routeOf(a, t, pick) {
+    for (const r of await a.routeRules()) {
+        if (!matches(t, r.filter))
+            continue;
+        const runner = r.runner;
+        return {
+            runner,
+            model: r.model,
+            lane: runner === "session" ? r.lane : runLane(runner),
+            why: r.why,
+            rule: r.id,
+            by: r.by,
+        };
+    }
+    if (!pick)
+        throw new AerieError(`no route rule matches ${t.id} and no router_model is set`, 409);
+    const p = await pick(t);
+    // the picker has no session lanes to name: a session it picks serves the task's area
+    return {
+        runner: p.runner,
+        model: p.model,
+        lane: p.runner === "session" ? t.area : runLane(p.runner),
+        why: p.why,
+        rule: null,
+        by: p.by,
+    };
+}
+/** headless: pinned to its lane, so a session serving every lane (`*`) never takes it */
+export const queueSpot = (r) => r.runner === "session" ? { lane: r.lane } : { lane: r.lane, pin: r.lane };
+/** route, log, queue; the task's own lane already holding it is fine (queueAdd moves it) */
+export async function route(a, coord, id, by, pick) {
+    const t = await a.get(id);
+    if (!t)
+        throw new AerieError(`no task ${id}`, 404);
+    const r = await routeOf(a, t, pick);
+    await a.log(t.id, by, "routed", {
+        runner: r.runner,
+        model: r.model,
+        lane: r.lane,
+        rule: r.rule,
+        picker: r.rule === null ? r.by : null,
+    }, r.why);
+    await coord.queueAdd([t.id], queueSpot(r));
+    return r;
+}
+/**
+ * After a decision on a task a runner had: back on a lane, or not. Answer `william`: assigned to him, off the queue.
+ * `session`: the session lane of its area. Else (`retry`, or words for an agent that asked): routed again.
+ */
+export async function afterDecision(a, coord, d, by, pick) {
+    const out = [];
+    for (const id of d.blocks) {
+        const t = await a.get(id);
+        if (t?.status !== "To Do" || !(await a.lastEvent(t.id, "run.start")))
+            continue;
+        if (d.answer === "william") {
+            await a.edit(t.id, { assignees: ["@william"] }, by, { why: `decision ${d.id}` });
+            out.push({ id: t.id, lane: null });
+        }
+        else if (d.answer === "session") {
+            await a.log(t.id, by, "routed", { runner: "session", model: null, lane: t.area, rule: null }, `decision ${d.id}`);
+            await coord.queueAdd([t.id], { lane: t.area });
+            out.push({ id: t.id, lane: t.area });
+        }
+        else
+            out.push({ id: t.id, lane: (await route(a, coord, t.id, by, pick)).lane });
+    }
+    return out;
+}
+//# sourceMappingURL=route.js.map

package/dist/run/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/run/route.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAmB,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAc,OAAO,EAAmB,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1E,mDAAmD;AACnD,MAAM,CAAC,MAAM,UAAU,GAA+B;IACpD,MAAM,EAAE,8DAA8D;IACtE,KAAK,EAAE,2BAA2B;IAClC,IAAI,EAAE,gCAAgC;IACtC,GAAG,EAAE,wDAAwD;IAC7D,eAAe,EAAE,kDAAkD;IACnE,OAAO,EAAE,mEAAmE;CAC7E,CAAC;AAMF,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IACvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACvB,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,MAA0C,OAAO,CAAC,GAAG;IAErD,OAAO,KAAK,EAAE,CAAC,EAAE,EAAE;QACjB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;QACtE,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,CAC3B;YACE,yCAAyC;YACzC,IAAI;YACJ,EAAE;YACF,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,MAAM,CAAC,CAAC,KAAK,EAAE;YACpF,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;YACjD,EAAE;YACF,wDAAwD;SACzD,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ,UAAU,CACX,CAAC;QACF,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;IACpF,CAAC,CAAC;AACJ,CAAC;AAED,sCAAsC;AACtC,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,CAAa,EAAE,CAAa,EAAE,IAAa;IACvE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;YAAE,SAAS;QACpC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAoB,CAAC;QACtC,OAAO;YACL,MAAM;YACN,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAE,CAAC,CAAC,IAAe,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YACjE,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,IAAI,EAAE,CAAC,CAAC,EAAE;YACV,EAAE,EAAE,CAAC,CAAC,EAAE;SACT,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,UAAU,CAAC,yBAAyB,CAAC,CAAC,EAAE,6BAA6B,EAAE,GAAG,CAAC,CAAC;IACjG,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,qFAAqF;IACrF,OAAO;QACL,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QACzD,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,IAAI,EAAE,IAAI;QACV,EAAE,EAAE,CAAC,CAAC,EAAE;KACT,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAiC,EAAE,EAAE,CAC7D,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAE5E,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,CAAa,EACb,KAAiB,EACjB,EAAU,EACV,EAAU,EACV,IAAa;IAEb,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,WAAW,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IACpC,MAAM,CAAC,CAAC,GAAG,CACT,CAAC,CAAC,EAAE,EACJ,EAAE,EACF,QAAQ,EACR;QACE,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;KACtC,EACD,CAAC,CAAC,GAAG,CACN,CAAC;IACF,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,CAAa,EACb,KAAiB,EACjB,CAAuE,EACvE,EAAU,EACV,IAAa;IAEb,MAAM,GAAG,GAA0C,EAAE,CAAC;IACtD,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;YAAE,SAAS;QAC/E,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACjF,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,CAAC,CAAC,GAAG,CACT,CAAC,CAAC,EAAE,EACJ,EAAE,EACF,QAAQ,EACR,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAC5D,YAAY,CAAC,CAAC,EAAE,EAAE,CACnB,CAAC;YACF,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/C,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;;YAAM,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/run/spawn.d.ts

@@ -0,0 +1,13 @@
+export interface Spawned {
+    code: number | null;
+    /** the signal that ended it, if any */
+    killed: string | null;
+    aborted: boolean;
+    stderr: string;
+}
+export declare function runLines(bin: string, args: string[], o: {
+    cwd: string;
+    env: Record<string, string>;
+    signal: AbortSignal;
+    onLine: (line: string) => Promise<void>;
+}): Promise<Spawned>;