@dungle-scrubs/harness-cli-normalizer 0.1.1

package/dist/execution/node-deps.d.ts

@@ -0,0 +1,13 @@
+import type { Readable } from "node:stream";
+import type { RunnerDeps } from "./deps.js";
+type SpawnOutcome = "spawned" | "failed";
+/** Request terminal disposal without discarding chunks already buffered by
+ * the runtime. Once the consumer reaches the first pending read, destruction
+ * settles that read with this adapter's unique disposal cause. */
+export declare const disposableOutputStream: (source: Readable, disposalCause: Error, spawnOutcome: Promise<SpawnOutcome>) => {
+    readonly stream: AsyncIterable<Uint8Array>;
+    dispose(): void;
+};
+export declare const nodeRunnerDeps: (extra?: Partial<RunnerDeps>) => RunnerDeps;
+export {};
+//# sourceMappingURL=node-deps.d.ts.map

package/dist/execution/node-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-deps.d.ts","sourceRoot":"","sources":["../../src/execution/node-deps.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAS,UAAU,EAAgC,MAAM,WAAW,CAAC;AAMjF,KAAK,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAwBzC;;kEAEkE;AAClE,eAAO,MAAM,sBAAsB,WACzB,QAAQ,iBACD,KAAK,gBACN,OAAO,CAAC,YAAY,CAAC,KAClC;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAAC,OAAO,IAAI,IAAI,CAAA;CAyC/D,CAAC;AAmFF,eAAO,MAAM,cAAc,WAAY,OAAO,CAAC,UAAU,CAAC,KAAG,UAO3D,CAAC"}

package/dist/execution/node-deps.js

@@ -0,0 +1,164 @@
+/**
+ * The real runtime adapter for RunnerDeps: node:child_process spawn (Bun
+ * implements the same module, so this is the Node AND Bun adapter), wall
+ * clock, and process signalling. This is the ONE module where the injected
+ * primitives touch the operating system - everything above it stays pure
+ * and fake-driven. Kills go to the exact child handle this adapter
+ * spawned, never to a pid pattern.
+ */
+import { spawn as nodeSpawn } from "node:child_process";
+const children = new WeakMap();
+const emptyStream = async function* () { };
+/** Normalize only errors created by this adapter's own terminal operations.
+ * Identity comparison keeps an unrelated read failure visible even when it
+ * settles after output disposal has started. */
+const normalizeOutputStream = async function* (source, disposalCause, spawnOutcome) {
+    try {
+        yield* source;
+    }
+    catch (cause) {
+        if (cause === disposalCause)
+            return;
+        if (cause?.code === "ERR_STREAM_PREMATURE_CLOSE" &&
+            (await spawnOutcome) === "failed") {
+            return;
+        }
+        throw cause;
+    }
+};
+/** Request terminal disposal without discarding chunks already buffered by
+ * the runtime. Once the consumer reaches the first pending read, destruction
+ * settles that read with this adapter's unique disposal cause. */
+export const disposableOutputStream = (source, disposalCause, spawnOutcome) => {
+    let disposalRequested = false;
+    let disposalDrainBudget = 0;
+    let readPending = false;
+    const destroyPendingRead = () => {
+        if (disposalRequested && readPending && disposalDrainBudget === 0 && !source.destroyed) {
+            source.destroy(disposalCause);
+        }
+    };
+    const drainBeforeDisposal = async function* () {
+        const iterator = source[Symbol.asyncIterator]();
+        while (true) {
+            readPending = true;
+            if (disposalRequested && disposalDrainBudget === 0 && !source.destroyed) {
+                source.destroy(disposalCause);
+            }
+            let next;
+            try {
+                next = await iterator.next();
+            }
+            finally {
+                readPending = false;
+            }
+            if (next.done)
+                return;
+            if (disposalRequested) {
+                const bytes = next.value;
+                disposalDrainBudget = Math.max(0, disposalDrainBudget - (bytes.byteLength ?? 0));
+            }
+            yield next.value;
+        }
+    };
+    return {
+        stream: normalizeOutputStream(drainBeforeDisposal(), disposalCause, spawnOutcome),
+        dispose: () => {
+            if (disposalRequested)
+                return;
+            disposalRequested = true;
+            disposalDrainBudget = source.readableLength;
+            destroyPendingRead();
+        },
+    };
+};
+const realSpawn = (argv, opts) => {
+    const [bin, ...args] = argv;
+    if (bin === undefined)
+        throw new Error("empty argv");
+    const child = nodeSpawn(bin, args, {
+        ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
+        stdio: [
+            opts.stdin === "pipe" ? "pipe" : opts.stdin === "close" ? "ignore" : "inherit",
+            "pipe",
+            "pipe",
+        ],
+    });
+    let outputDisposed = false;
+    const stdoutDisposalCause = new Error("stdout disposed by runner");
+    const stderrDisposalCause = new Error("stderr disposed by runner");
+    let spawnError = null;
+    const spawnOutcome = new Promise((resolve) => {
+        child.once("spawn", () => resolve("spawned"));
+        child.once("error", () => resolve("failed"));
+    });
+    const stdoutOutput = child.stdout === null
+        ? null
+        : disposableOutputStream(child.stdout, stdoutDisposalCause, spawnOutcome);
+    const stderrOutput = child.stderr === null
+        ? null
+        : disposableOutputStream(child.stderr, stderrDisposalCause, spawnOutcome);
+    // exited resolves via 'exit' (process died - fires even while a grandchild
+    // holds the pipes open, unlike 'close') or 'error' (ENOENT etc., which
+    // node reports async, not as a sync throw -> map to 127 crash). The error
+    // handler sets spawnError before it resolves exited.
+    const exited = new Promise((resolve) => {
+        child.on("error", (err) => {
+            spawnError = err;
+            resolve(127);
+        });
+        child.on("exit", (code) => resolve(code));
+    });
+    // The spawn error rides the stderr stream so the runner's tail (and the
+    // crash exit log) carry the explanation, matching the sync-throw path.
+    // normalizeOutputStream waits only for the spawn/error outcome when it sees a
+    // premature close, so a genuine read failure on a live child propagates
+    // immediately while an async ENOENT remains the single spawn-error signal.
+    const stderrWithError = async function* () {
+        if (stderrOutput !== null)
+            yield* stderrOutput.stream;
+        await exited;
+        if (spawnError !== null)
+            yield `spawn failed: ${spawnError.message}\n`;
+    };
+    const proc = {
+        stdout: stdoutOutput === null ? emptyStream() : stdoutOutput.stream,
+        stderr: stderrWithError(),
+        exited,
+        disposeOutput: () => {
+            if (outputDisposed)
+                return;
+            outputDisposed = true;
+            stdoutOutput?.dispose();
+            stderrOutput?.dispose();
+        },
+        ...(opts.stdin === "pipe" && child.stdin !== null
+            ? {
+                stdin: {
+                    write: (data) => {
+                        child.stdin?.write(data);
+                    },
+                    end: () => {
+                        child.stdin?.end();
+                    },
+                },
+            }
+            : {}),
+    };
+    children.set(proc, child);
+    return proc;
+};
+const realClock = {
+    now: () => Date.now(),
+    setTimeout: (fn, ms) => setTimeout(fn, ms),
+    clearTimeout: (handle) => clearTimeout(handle),
+};
+export const nodeRunnerDeps = (extra) => ({
+    spawn: realSpawn,
+    clock: realClock,
+    signal: (proc, sig) => {
+        children.get(proc)?.kill(sig);
+    },
+    ...extra,
+});
+//# sourceMappingURL=node-deps.js.map

package/dist/execution/node-deps.js.map

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

package/dist/execution/open-session.d.ts

@@ -0,0 +1,31 @@
+import type { HarnessDescriptor } from "../knowledge/descriptor.js";
+import type { RunnerDeps } from "./deps.js";
+import type { HarnessEvent } from "./events.js";
+/** Grace after stdin EOF before concluding the child will not exit on its
+ * own and escalating signals. */
+export declare const CLOSE_GRACE_MS = 5000;
+export interface SessionSendResult {
+    readonly disposition: "started" | "queued";
+}
+export interface SessionHandle {
+    /** One inner iterable per turn, each ending in a turn-scoped `done`.
+     * Breaking out of THIS iterable closes the session; breaking out of a
+     * single turn's iterable only stops reading that turn. */
+    readonly turns: AsyncIterable<AsyncIterable<HarnessEvent>>;
+    send(text: string): SessionSendResult;
+    close(): Promise<void>;
+}
+export interface OpenSessionOptions {
+    readonly sessionId: string;
+    readonly model?: string;
+    /** Working directory for the spawned harness. */
+    readonly cwd?: string;
+}
+export declare class SessionClosedError extends Error {
+    constructor();
+}
+export declare class SessionSpawnError extends Error {
+    constructor(harness: string, cause: unknown);
+}
+export declare const openSession: (h: HarnessDescriptor, opts: OpenSessionOptions, deps: RunnerDeps) => SessionHandle;
+//# sourceMappingURL=open-session.d.ts.map

package/dist/execution/open-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-session.d.ts","sourceRoot":"","sources":["../../src/execution/open-session.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,iBAAiB,EAAwB,MAAM,4BAA4B,CAAC;AAG1F,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,WAAW,CAAC;AAC5D,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3D;iCACiC;AACjC,eAAO,MAAM,cAAc,OAAQ,CAAC;AAIpC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B;;8DAE0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,cAGC;CACF;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAK1C;CACF;AAED,eAAO,MAAM,WAAW,MACnB,iBAAiB,QACd,kBAAkB,QAClB,UAAU,KACf,aA2TF,CAAC"}

package/dist/execution/open-session.js

@@ -0,0 +1,360 @@
+/**
+ * openSession: the persistent headless session runner - ONE process, many
+ * turns (A-001). `send` during idle writes a descriptor-encoded user record to
+ * stdin and starts a turn; `send` during a live turn is QUEUED to the next
+ * boundary (mid-turn stdin writes would interleave into the model's
+ * context unpredictably - the harness itself queues, so we mirror its
+ * disposition). `result` lines delimit turns; identity dedupe (D-022)
+ * spans the whole session. Lifecycle is bounded end to end: close() ends
+ * stdin, escalates SIGTERM->SIGKILL if the child ignores EOF, and pipes
+ * held open past exit close out after grace - a session can always be
+ * ended. Queued sends that die with the session are surfaced, never
+ * silently dropped. Structured lifecycle events (session open/close, turn
+ * start/end, send dispositions, drops) are always-on evidence with
+ * sessionId + turnId correlation.
+ */
+import { buildSessionArgv } from "../interpretation/argv.js";
+import { detectAuthFailureInLine, detectLimitInLine } from "../interpretation/limits.js";
+import { encodeSessionInput, resolveSessionInput, SessionInputRefusalError, } from "../interpretation/session-input.js";
+import { AsyncChannel } from "./channel.js";
+import { decodeParsed, freshDecodeState } from "./decode.js";
+import { LineBuffer } from "./lines.js";
+import { KILL_GRACE_MS, PIPE_GRACE_MS, redactArgv, StderrTail } from "./stream-turn.js";
+/** Grace after stdin EOF before concluding the child will not exit on its
+ * own and escalating signals. */
+export const CLOSE_GRACE_MS = 5_000;
+const PRETURN_MAX = 256;
+export class SessionClosedError extends Error {
+    constructor() {
+        super("session is closed; sends have nowhere to go");
+        this.name = "SessionClosedError";
+    }
+}
+export class SessionSpawnError extends Error {
+    constructor(harness, cause) {
+        super(`could not spawn a ${harness} session: ${cause instanceof Error ? cause.message : String(cause)}`);
+        this.name = "SessionSpawnError";
+    }
+}
+export const openSession = (h, opts, deps) => {
+    const log = deps.log ?? (() => { });
+    const argv = buildSessionArgv(h, {
+        sessionId: opts.sessionId,
+        ...(opts.model !== undefined ? { model: opts.model } : {}),
+    });
+    let sessionInput;
+    try {
+        sessionInput = resolveSessionInput(h);
+    }
+    catch (cause) {
+        if (!(cause instanceof SessionInputRefusalError))
+            throw cause;
+        log({
+            event: "session_input_refused",
+            harness: h.name,
+            issue: cause.issue,
+            sessionId: opts.sessionId,
+        });
+        throw cause;
+    }
+    let proc;
+    try {
+        // A session needs a writable stdin regardless of the descriptor's
+        // one-shot stdin policy - that policy governs turns, not sessions.
+        proc = deps.spawn(argv, {
+            stdin: "pipe",
+            ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
+        });
+    }
+    catch (cause) {
+        log({ event: "session_spawn_failed", sessionId: opts.sessionId, harness: h.name });
+        throw new SessionSpawnError(h.name, cause);
+    }
+    const stdin = proc.stdin;
+    if (stdin === undefined) {
+        // The child exists but there is no way to ever send to it - end it
+        // before throwing, or it runs orphaned forever.
+        deps.signal(proc, "SIGTERM");
+        log({ event: "session_spawn_failed", sessionId: opts.sessionId, harness: h.name });
+        throw new SessionSpawnError(h.name, new Error("spawner opened no stdin pipe"));
+    }
+    log({
+        event: "session_open",
+        sessionId: opts.sessionId,
+        harness: h.name,
+        argv: redactArgv(argv),
+    });
+    const turnsChannel = new AsyncChannel();
+    const state = freshDecodeState(opts.sessionId);
+    const stderrTail = new StderrTail();
+    let turnCounter = 0;
+    let activeTurn = null;
+    let activeTurnId = "";
+    const pendingSends = [];
+    const preTurnEvents = [];
+    let dead = false;
+    let closing = false;
+    let finalized = false;
+    let exitCode = null;
+    let resultError = false;
+    let turnLimitSeen = false;
+    let pumpError = null;
+    const safeSignal = (sig) => {
+        if (!dead)
+            deps.signal(proc, sig);
+    };
+    const escalate = () => {
+        safeSignal("SIGTERM");
+        deps.clock.setTimeout(() => safeSignal("SIGKILL"), KILL_GRACE_MS);
+    };
+    const writeUser = (text) => {
+        try {
+            stdin.write(encodeSessionInput(sessionInput, text));
+            return true;
+        }
+        catch {
+            activeTurn?.push({ kind: "error", message: "send failed: session stdin is gone" });
+            return false;
+        }
+    };
+    const startTurn = () => {
+        turnLimitSeen = false;
+        activeTurn = new AsyncChannel();
+        activeTurnId = `${opts.sessionId}:turn-${++turnCounter}`;
+        log({ event: "turn_start", sessionId: opts.sessionId, turnId: activeTurnId });
+        for (const held of preTurnEvents.splice(0))
+            activeTurn.push(held);
+        turnsChannel.push(activeTurn);
+    };
+    const endTurn = (done) => {
+        if (activeTurn === null)
+            return;
+        activeTurn.push(done);
+        activeTurn.close();
+        log({
+            event: "turn_end",
+            sessionId: opts.sessionId,
+            turnId: activeTurnId,
+            cause: done.cause,
+        });
+        activeTurn = null;
+        resultError = false;
+        // The boundary is the only legal delivery point for queued input.
+        if (dead || closing)
+            return;
+        const next = pendingSends.shift();
+        if (next !== undefined && writeUser(next))
+            startTurn();
+    };
+    const routeEvent = (event) => {
+        if (event.kind === "limit") {
+            state.limitSeen = true;
+            turnLimitSeen = true;
+        }
+        if (activeTurn !== null) {
+            // Awaited by the pumps: past the channel's high water mark this
+            // blocks the pump, so OS pipe backpressure reaches the child.
+            return activeTurn.push(event);
+        }
+        // Between-turn events wait for the next turn, bounded: past the cap
+        // droppable events go first, then oldest.
+        preTurnEvents.push(event);
+        if (preTurnEvents.length > PRETURN_MAX) {
+            const droppableAt = preTurnEvents.findIndex((e) => e.kind === "token" || e.kind === "progress" || e.kind === "context");
+            preTurnEvents.splice(droppableAt === -1 ? 0 : droppableAt, 1);
+        }
+        return Promise.resolve();
+    };
+    const pumpStdout = async () => {
+        const lines = new LineBuffer();
+        const handleLine = async (line) => {
+            let parsed = null;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                const code = detectLimitInLine(h, line);
+                if (code !== null) {
+                    await routeEvent({ kind: "limit", code, message: `limit wall detected (${code})` });
+                }
+                return;
+            }
+            // The result line still feeds identity dedupe (claude includes
+            // session_id on it - a rotation announced there must not be missed).
+            const events = decodeParsed(h, parsed, state, opts.model ?? "");
+            if (parsed.type === "result") {
+                // decodeParsed already surfaces the is_error case as an error event
+                // (content.ts claude reader); routing the events is enough - we only
+                // still track resultError here to classify the done cause.
+                for (const event of events)
+                    await routeEvent(event);
+                if (parsed.is_error === true)
+                    resultError = true;
+                endTurn({
+                    kind: "done",
+                    exitCode: null,
+                    cause: turnLimitSeen ? "limit" : resultError ? "crash" : "clean",
+                });
+                return;
+            }
+            for (const event of events)
+                await routeEvent(event);
+        };
+        for await (const chunk of proc.stdout) {
+            for (const line of lines.push(chunk))
+                await handleLine(line);
+        }
+        const rest = lines.flush();
+        if (rest !== null)
+            await handleLine(rest);
+    };
+    const pumpStderr = async () => {
+        const lines = new LineBuffer();
+        for await (const chunk of proc.stderr) {
+            for (const line of lines.push(chunk)) {
+                const limit = detectLimitInLine(h, line);
+                if (limit !== null) {
+                    await routeEvent({
+                        kind: "limit",
+                        code: limit,
+                        message: `limit wall detected (${limit})`,
+                    });
+                    continue;
+                }
+                const auth = detectAuthFailureInLine(h, line);
+                if (auth !== null) {
+                    await routeEvent({ kind: "error", message: `auth wall: ${auth}` });
+                    continue;
+                }
+                stderrTail.push(line);
+            }
+        }
+    };
+    const pumping = Promise.allSettled([pumpStdout(), pumpStderr()]).then((settlements) => {
+        pumpError = settlements.find((settlement) => settlement.status === "rejected")?.reason ?? null;
+    });
+    let shutdownComplete = () => { };
+    const shutdown = new Promise((resolve) => {
+        shutdownComplete = resolve;
+    });
+    let pipesOpenAtExit = false;
+    const finalize = () => {
+        if (finalized)
+            return;
+        finalized = true;
+        const cause = state.limitSeen
+            ? "limit"
+            : exitCode === 0
+                ? "clean"
+                : exitCode === null
+                    ? "killed"
+                    : "crash";
+        if (pumpError !== null) {
+            void routeEvent({ kind: "error", message: `session pump failed: ${String(pumpError)}` });
+        }
+        if (pendingSends.length > 0) {
+            // "queued" was an accepted disposition - the loss must be visible to
+            // both the log and the consumer, never silent.
+            void routeEvent({
+                kind: "error",
+                message: `${pendingSends.length} queued send(s) died with the session`,
+            });
+            log({
+                event: "sends_dropped",
+                sessionId: opts.sessionId,
+                count: pendingSends.length,
+                lengths: pendingSends.map((s) => s.length),
+            });
+            pendingSends.length = 0;
+        }
+        endTurn({ kind: "done", exitCode, cause });
+        if (preTurnEvents.some((e) => e.kind !== "token" && e.kind !== "progress")) {
+            log({
+                event: "preturn_events_dropped",
+                sessionId: opts.sessionId,
+                kinds: preTurnEvents.map((e) => e.kind),
+            });
+        }
+        turnsChannel.close();
+        log({
+            event: "session_close",
+            sessionId: opts.sessionId,
+            exitCode,
+            cause,
+            ...(pipesOpenAtExit ? { pipesOpenAtExit } : {}),
+            ...(cause === "crash" || cause === "killed" ? { stderrTail: stderrTail.snapshot() } : {}),
+        });
+        shutdownComplete();
+    };
+    void proc.exited.then((code) => {
+        dead = true;
+        exitCode = code;
+        // Pipes held open past exit (a grandchild) must not hang the session.
+        const pipeGrace = deps.clock.setTimeout(() => {
+            pipesOpenAtExit = true;
+            activeTurn?.releaseBackpressure();
+            proc.disposeOutput();
+            void pumping.then(() => finalize());
+        }, PIPE_GRACE_MS);
+        void pumping.then(() => {
+            deps.clock.clearTimeout(pipeGrace);
+            finalize();
+        });
+    });
+    const close = async () => {
+        if (closing)
+            return shutdown;
+        closing = true;
+        try {
+            stdin.end();
+        }
+        catch {
+            // stdin may already be gone - escalation below still bounds close.
+        }
+        // A child that does not exit on stdin EOF gets signalled after grace.
+        const closeGrace = deps.clock.setTimeout(() => escalate(), CLOSE_GRACE_MS);
+        await shutdown;
+        deps.clock.clearTimeout(closeGrace);
+    };
+    return {
+        // Breaking out of the turns iterable is abandonment - treat it as
+        // close() so the child is never left running undrained (the streamTurn
+        // C1 scar, adapted to a handle-shaped API).
+        turns: (async function* () {
+            try {
+                for await (const turn of turnsChannel)
+                    yield turn;
+            }
+            finally {
+                if (!closing && !dead)
+                    void close();
+            }
+        })(),
+        send(text) {
+            if (dead || closing)
+                throw new SessionClosedError();
+            if (activeTurn !== null) {
+                pendingSends.push(text);
+                log({
+                    event: "send",
+                    sessionId: opts.sessionId,
+                    turnId: activeTurnId,
+                    disposition: "queued",
+                });
+                return { disposition: "queued" };
+            }
+            if (!writeUser(text))
+                throw new SessionClosedError();
+            startTurn();
+            log({
+                event: "send",
+                sessionId: opts.sessionId,
+                turnId: activeTurnId,
+                disposition: "started",
+            });
+            return { disposition: "started" };
+        },
+        close,
+    };
+};
+//# sourceMappingURL=open-session.js.map

package/dist/execution/open-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-session.js","sourceRoot":"","sources":["../../src/execution/open-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG7D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAExF;iCACiC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AAEpC,MAAM,WAAW,GAAG,GAAG,CAAC;AAsBxB,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C;QACE,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe,EAAE,KAAc;QACzC,KAAK,CACH,qBAAqB,OAAO,aAAa,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAClG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,CAAoB,EACpB,IAAwB,EACxB,IAAgB,EACD,EAAE;IACjB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,EAAE;QAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC,CAAC;IACH,IAAI,YAAkC,CAAC;IACvC,IAAI,CAAC;QACH,YAAY,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,wBAAwB,CAAC;YAAE,MAAM,KAAK,CAAC;QAC9D,GAAG,CAAC;YACF,KAAK,EAAE,uBAAuB;YAC9B,OAAO,EAAE,CAAC,CAAC,IAAI;YACf,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,IAAoB,CAAC;IACzB,IAAI,CAAC;QACH,kEAAkE;QAClE,mEAAmE;QACnE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YACtB,KAAK,EAAE,MAAM;YACb,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnF,MAAM,IAAI,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,mEAAmE;QACnE,gDAAgD;QAChD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC7B,GAAG,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnF,MAAM,IAAI,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,GAAG,CAAC;QACF,KAAK,EAAE,cAAc;QACrB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,CAAC,CAAC,IAAI;QACf,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC;KACvB,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,IAAI,YAAY,EAA+B,CAAC;IACrE,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IACpC,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,UAAU,GAAsC,IAAI,CAAC;IACzD,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,aAAa,GAAmB,EAAE,CAAC;IACzC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,SAAS,GAAY,IAAI,CAAC;IAE9B,MAAM,UAAU,GAAG,CAAC,GAA0B,EAAQ,EAAE;QACtD,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,UAAU,CAAC,SAAS,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,CAAC;IACpE,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,IAAY,EAAW,EAAE;QAC1C,IAAI,CAAC;YACH,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;YACnF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,GAAS,EAAE;QAC3B,aAAa,GAAG,KAAK,CAAC;QACtB,UAAU,GAAG,IAAI,YAAY,EAAgB,CAAC;QAC9C,YAAY,GAAG,GAAG,IAAI,CAAC,SAAS,SAAS,EAAE,WAAW,EAAE,CAAC;QACzD,GAAG,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QAC9E,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,IAAqC,EAAQ,EAAE;QAC9D,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO;QAChC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,GAAG,CAAC;YACF,KAAK,EAAE,UAAU;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,YAAY;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,UAAU,GAAG,IAAI,CAAC;QAClB,WAAW,GAAG,KAAK,CAAC;QACpB,kEAAkE;QAClE,IAAI,IAAI,IAAI,OAAO;YAAE,OAAO;QAC5B,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,CAAC;YAAE,SAAS,EAAE,CAAC;IACzD,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,KAAmB,EAAiB,EAAE;QACxD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC3B,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;YACvB,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,gEAAgE;YAChE,8DAA8D;YAC9D,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,oEAAoE;QACpE,0CAA0C;QAC1C,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,aAAa,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YACvC,MAAM,WAAW,GAAG,aAAa,CAAC,SAAS,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAC3E,CAAC;YACF,aAAa,CAAC,MAAM,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,IAAmB,EAAE;QAC3C,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;YACvD,IAAI,MAAM,GAAmC,IAAI,CAAC;YAClD,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;YACvD,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,GAAG,iBAAiB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACxC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBAClB,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,wBAAwB,IAAI,GAAG,EAAE,CAAC,CAAC;gBACtF,CAAC;gBACD,OAAO;YACT,CAAC;YACD,+DAA+D;YAC/D,qEAAqE;YACrE,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAChE,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,oEAAoE;gBACpE,qEAAqE;gBACrE,2DAA2D;gBAC3D,KAAK,MAAM,KAAK,IAAI,MAAM;oBAAE,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;gBACpD,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI;oBAAE,WAAW,GAAG,IAAI,CAAC;gBACjD,OAAO,CAAC;oBACN,IAAI,EAAE,MAAM;oBACZ,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;iBACjE,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,MAAM;gBAAE,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC,CAAC;QACF,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,IAAI,KAAK,IAAI;YAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,KAAK,IAAmB,EAAE;QAC3C,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrC,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBACzC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,MAAM,UAAU,CAAC;wBACf,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,KAAK;wBACX,OAAO,EAAE,wBAAwB,KAAK,GAAG;qBAC1C,CAAC,CAAC;oBACH,SAAS;gBACX,CAAC;gBACD,MAAM,IAAI,GAAG,uBAAuB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;gBAC9C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBAClB,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,IAAI,EAAE,EAAE,CAAC,CAAC;oBACnE,SAAS;gBACX,CAAC;gBACD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;QACpF,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,IAAI,gBAAgB,GAAe,GAAG,EAAE,GAAE,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC7C,gBAAgB,GAAG,OAAO,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,IAAI,SAAS;YAAE,OAAO;QACtB,SAAS,GAAG,IAAI,CAAC;QACjB,MAAM,KAAK,GAAc,KAAK,CAAC,SAAS;YACtC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,QAAQ,KAAK,CAAC;gBACd,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,QAAQ,KAAK,IAAI;oBACjB,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,OAAO,CAAC;QAChB,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,KAAK,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,qEAAqE;YACrE,+CAA+C;YAC/C,KAAK,UAAU,CAAC;gBACd,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,GAAG,YAAY,CAAC,MAAM,uCAAuC;aACvE,CAAC,CAAC;YACH,GAAG,CAAC;gBACF,KAAK,EAAE,eAAe;gBACtB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,KAAK,EAAE,YAAY,CAAC,MAAM;gBAC1B,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;aAC3C,CAAC,CAAC;YACH,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3C,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC;gBACF,KAAK,EAAE,wBAAwB;gBAC/B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aACxC,CAAC,CAAC;QACL,CAAC;QACD,YAAY,CAAC,KAAK,EAAE,CAAC;QACrB,GAAG,CAAC;YACF,KAAK,EAAE,eAAe;YACtB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ;YACR,KAAK;YACL,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1F,CAAC,CAAC;QACH,gBAAgB,EAAE,CAAC;IACrB,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QAC7B,IAAI,GAAG,IAAI,CAAC;QACZ,QAAQ,GAAG,IAAI,CAAC;QAChB,sEAAsE;QACtE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE;YAC3C,eAAe,GAAG,IAAI,CAAC;YACvB,UAAU,EAAE,mBAAmB,EAAE,CAAC;YAClC,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtC,CAAC,EAAE,aAAa,CAAC,CAAC;QAClB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YACnC,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;QACtC,IAAI,OAAO;YAAE,OAAO,QAAQ,CAAC;QAC7B,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,CAAC;YACH,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;QACrE,CAAC;QACD,sEAAsE;QACtE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAC;QAC3E,MAAM,QAAQ,CAAC;QACf,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,OAAO;QACL,kEAAkE;QAClE,uEAAuE;QACvE,4CAA4C;QAC5C,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC;YACrB,IAAI,CAAC;gBACH,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,YAAY;oBAAE,MAAM,IAAI,CAAC;YACpD,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI;oBAAE,KAAK,KAAK,EAAE,CAAC;YACtC,CAAC;QACH,CAAC,CAAC,EAAE;QACJ,IAAI,CAAC,IAAY;YACf,IAAI,IAAI,IAAI,OAAO;gBAAE,MAAM,IAAI,kBAAkB,EAAE,CAAC;YACpD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACxB,GAAG,CAAC;oBACF,KAAK,EAAE,MAAM;oBACb,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,MAAM,EAAE,YAAY;oBACpB,WAAW,EAAE,QAAQ;iBACtB,CAAC,CAAC;gBACH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;YACnC,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,kBAAkB,EAAE,CAAC;YACrD,SAAS,EAAE,CAAC;YACZ,GAAG,CAAC;gBACF,KAAK,EAAE,MAAM;gBACb,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,MAAM,EAAE,YAAY;gBACpB,WAAW,EAAE,SAAS;aACvB,CAAC,CAAC;YACH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QACpC,CAAC;QACD,KAAK;KACN,CAAC;AACJ,CAAC,CAAC"}

package/dist/execution/stream-turn.d.ts

@@ -0,0 +1,43 @@
+/**
+ * streamTurn: the spawn-per-turn headless runner. Spawn, drain both stdio
+ * streams concurrently, decode typed HarnessEvents, watchdog stalls (only
+ * for none-granularity invocations - a structured stream proves its own
+ * liveness), classify the exit, always end with `done` (spawn failures
+ * included). Runtime primitives are injected (D-005); structured boundary
+ * events (spawn/exit/stall, argv redacted by POSITION) are always-on
+ * evidence, not diagnostics. An abandoned turn (consumer breaks early)
+ * closes backpressure, disposes output, stops the child, and awaits both
+ * pumps before it returns.
+ */
+import { type LaunchOptions } from "../interpretation/argv.js";
+import type { HarnessDescriptor } from "../knowledge/descriptor.js";
+import type { RunnerDeps } from "./deps.js";
+import type { HarnessEvent } from "./events.js";
+/** SIGTERM -> SIGKILL escalation budget for a child that ignores the first
+ * signal, and the grace allowed for pipes still held open (by a grandchild)
+ * after the process itself exited. */
+export declare const KILL_GRACE_MS = 5000;
+export declare const PIPE_GRACE_MS = 2000;
+/** Redact by POSITION, not shape: the prompt is a known argv slot and is
+ * masked wholesale (content never reaches a log line - v1 D-005); every
+ * other token is kept unless it is secret-shaped. */
+export declare const redactArgv: (argv: readonly string[], prompt?: string) => string[];
+/** Bounded tail of unmatched stderr - the crash context a nonzero exit is
+ * explained by (v1 kept the turn's output slice for exactly this). Shared
+ * with the session runner. */
+export declare class StderrTail {
+    private readonly lines;
+    private bytes;
+    push(line: string): void;
+    snapshot(): readonly string[];
+}
+export interface TurnRunOptions extends LaunchOptions {
+    /** Resume this session id instead of launching fresh - the turn spawns
+     * with the descriptor's resume grammar, and identity decoding treats a
+     * DIFFERENT announced id as a rotation anomaly. */
+    readonly resume?: string;
+    /** Working directory for the spawned harness. */
+    readonly cwd?: string;
+}
+export declare function streamTurn(h: HarnessDescriptor, opts: TurnRunOptions, deps: RunnerDeps): AsyncIterable<HarnessEvent>;
+//# sourceMappingURL=stream-turn.d.ts.map

package/dist/execution/stream-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-turn.d.ts","sourceRoot":"","sources":["../../src/execution/stream-turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,WAAW,CAAC;AAC5D,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3D;;sCAEsC;AACtC,eAAO,MAAM,aAAa,OAAQ,CAAC;AACnC,eAAO,MAAM,aAAa,OAAQ,CAAC;AAWnC;;qDAEqD;AACrD,eAAO,MAAM,UAAU,SAAU,SAAS,MAAM,EAAE,WAAW,MAAM,KAAG,MAAM,EAKxE,CAAC;AAEL;;8BAE8B;AAC9B,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,KAAK,CAAK;IAClB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAOvB;IACD,QAAQ,IAAI,SAAS,MAAM,EAAE,CAE5B;CACF;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD;;uDAEmD;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAuB,UAAU,CAC/B,CAAC,EAAE,iBAAiB,EACpB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,UAAU,GACf,aAAa,CAAC,YAAY,CAAC,CA8N7B"}