@db-lyon/flowkit 0.12.0 → 0.13.0

package/dist/.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/index.ts","../src/logger.ts","../src/references.ts","../src/config/deep-merge.ts","../src/config/index.ts","../src/config/loader.ts","../src/config/schema.ts","../src/dag/index.ts","../src/dag/resolver.ts","../src/flow/index.ts","../src/flow/runner.ts","../src/task/agent-prompt-task.ts","../src/task/agent-task.ts","../src/task/base-task.ts","../src/task/concurrency.ts","../src/task/index.ts","../src/task/json-schema.ts","../src/task/llm-provider.ts","../src/task/llm-runner.ts","../src/task/redact.ts","../src/task/registry.ts","../src/task/shell-task.ts","../src/task/shell-termination.ts","../src/task/task-resolution.ts","../src/task/token-ledger.ts"],"version":"5.9.3"}

package/dist/flow/references.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Reference resolution for flow option values.
+ *
+ * Option values may contain `${<namespace>.<path>}` references:
+ *
+ *   ${steps.<id>.<path>}  → value from a previously completed step
+ *   ${error.<path>}       → error info, only inside on_failure / finally hooks
+ *   ${<ns>.<path>}        → value from a host-supplied namespace in `namespaces`
+ *                           (e.g. ${project.package.namespace}, ${org.username},
+ *                           ${env.HOME}) — the resolver is namespace-extensible,
+ *                           symmetric with the pluggable `conditionEvaluator`.
+ *
+ * For `steps`, `<id>` is a step number ("3") or a task name ("level.place_actor");
+ * task names match the most recently completed step with that name, longest-prefix
+ * wins. A reference filling the entire string yields the raw value (preserving
+ * object/array/number types); embedded references are stringified. A reference to
+ * an UNREGISTERED namespace is left untouched (so non-reference `${...}` survives).
+ */
+export interface ReferenceableStep {
+    stepNumber: number;
+    name: string;
+    result?: {
+        data?: unknown;
+    };
+}
+export interface ReferenceContext {
+    steps: ReferenceableStep[];
+    /** Present inside on_failure / finally hooks. */
+    error?: {
+        message: string;
+        name: string;
+        stack?: string;
+        step?: string;
+    };
+    /** Host-supplied reference namespaces, e.g. { project, org, env }. */
+    namespaces?: Record<string, unknown>;
+}
+export declare function resolveReferences<T>(value: T, ctx: ReferenceContext): T;
+//# sourceMappingURL=references.d.ts.map

package/dist/flow/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/flow/references.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAQD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,gBAAgB,GAAG,CAAC,CAcvE"}

package/dist/flow/references.js

@@ -0,0 +1,102 @@
+/**
+ * Reference resolution for flow option values.
+ *
+ * Option values may contain `${<namespace>.<path>}` references:
+ *
+ *   ${steps.<id>.<path>}  → value from a previously completed step
+ *   ${error.<path>}       → error info, only inside on_failure / finally hooks
+ *   ${<ns>.<path>}        → value from a host-supplied namespace in `namespaces`
+ *                           (e.g. ${project.package.namespace}, ${org.username},
+ *                           ${env.HOME}) — the resolver is namespace-extensible,
+ *                           symmetric with the pluggable `conditionEvaluator`.
+ *
+ * For `steps`, `<id>` is a step number ("3") or a task name ("level.place_actor");
+ * task names match the most recently completed step with that name, longest-prefix
+ * wins. A reference filling the entire string yields the raw value (preserving
+ * object/array/number types); embedded references are stringified. A reference to
+ * an UNREGISTERED namespace is left untouched (so non-reference `${...}` survives).
+ */
+/** Returned by resolveRef when the namespace is unregistered — leave the text literal. */
+const LITERAL = Symbol('literal');
+const WHOLE_VALUE = /^\$\{(\w+)\.([^}]+)\}$/;
+const EMBEDDED = /\$\{(\w+)\.([^}]+)\}/g;
+export function resolveReferences(value, ctx) {
+    if (value == null)
+        return value;
+    if (typeof value === 'string')
+        return resolveString(value, ctx);
+    if (Array.isArray(value)) {
+        return value.map((v) => resolveReferences(v, ctx));
+    }
+    if (typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = resolveReferences(v, ctx);
+        }
+        return out;
+    }
+    return value;
+}
+function resolveString(str, ctx) {
+    const whole = str.match(WHOLE_VALUE);
+    if (whole) {
+        const v = resolveRef(whole[1], whole[2], ctx);
+        return v === LITERAL ? str : v;
+    }
+    if (!str.includes('${'))
+        return str;
+    return str.replace(EMBEDDED, (match, ns, ref) => {
+        const v = resolveRef(ns, ref, ctx);
+        if (v === LITERAL)
+            return match; // unregistered namespace — leave untouched
+        if (v == null)
+            return '';
+        if (typeof v === 'object')
+            return JSON.stringify(v);
+        return String(v);
+    });
+}
+function resolveRef(namespace, ref, ctx) {
+    if (namespace === 'error') {
+        if (!ctx.error) {
+            throw new Error(`\${error.${ref}} referenced outside on_failure/finally — error context not available`);
+        }
+        return getPath(ctx.error, ref.split('.'));
+    }
+    if (namespace === 'steps') {
+        const segments = ref.split('.');
+        for (let i = segments.length; i >= 1; i--) {
+            const idCandidate = segments.slice(0, i).join('.');
+            const match = findStep(idCandidate, ctx.steps);
+            if (match)
+                return getPath(match.result?.data, segments.slice(i));
+        }
+        throw new Error(`Unresolvable step reference: \${steps.${ref}} — no completed step matches "${segments[0]}"`);
+    }
+    // Host-supplied namespace (project / org / env / ...). Missing path → undefined.
+    if (ctx.namespaces && namespace in ctx.namespaces) {
+        return getPath(ctx.namespaces[namespace], ref.split('.'));
+    }
+    // Unregistered namespace — not a reference we own; leave it literal.
+    return LITERAL;
+}
+function findStep(id, steps) {
+    if (/^\d+$/.test(id)) {
+        return steps.find((s) => String(s.stepNumber) === id);
+    }
+    for (let i = steps.length - 1; i >= 0; i--) {
+        if (steps[i].name === id)
+            return steps[i];
+    }
+    return undefined;
+}
+function getPath(obj, segments) {
+    let cur = obj;
+    for (const seg of segments) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[seg];
+    }
+    return cur;
+}
+//# sourceMappingURL=references.js.map

package/dist/flow/references.js.map

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

package/dist/references.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAQD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,gBAAgB,GAAG,CAAC,CAcvE"}
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAQD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,gBAAgB,GAAG,CAAC,CAmBvE"}

package/dist/references.js

@@ -31,6 +31,12 @@ export function resolveReferences(value, ctx) {
         return value.map((v) => resolveReferences(v, ctx));
     }
     if (typeof value === 'object') {
+        // Configuration is represented by plain objects. Preserve runtime values
+        // (AbortSignal, Date, class instances, etc.) by identity: recursively
+        // copying them can discard non-enumerable state and methods.
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null)
+            return value;
         const out = {};
         for (const [k, v] of Object.entries(value)) {
             out[k] = resolveReferences(v, ctx);

package/dist/references.js.map

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

package/dist/task/shell-task.d.ts

@@ -3,6 +3,8 @@ export interface ShellTaskOptions {
     command: string;
     cwd?: string;
     timeout?: number;
+    /** Cancels this individual shell invocation when aborted. */
+    signal?: AbortSignal;
 }
 /**
  * Task that executes a shell command.

package/dist/task/shell-task.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell-task.d.ts","sourceRoot":"","sources":["../../src/task/shell-task.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,SAAU,SAAQ,QAAQ,CAAC,gBAAgB,CAAC;IACvD,IAAI,QAAQ,WAEX;IAED,SAAS,CAAC,QAAQ,IAAI,IAAI;IAMpB,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;CA8GrC"}
+{"version":3,"file":"shell-task.d.ts","sourceRoot":"","sources":["../../src/task/shell-task.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAQ3D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAWD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,SAAU,SAAQ,QAAQ,CAAC,gBAAgB,CAAC;IACvD,IAAI,QAAQ,WAEX;IAED,SAAS,CAAC,QAAQ,IAAI,IAAI;IASpB,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;CA6PrC"}

package/dist/task/shell-task.js

@@ -1,5 +1,13 @@
 import { spawn } from 'node:child_process';
 import { BaseTask } from './base-task.js';
+import { beginShellTermination, POSIX_SIGTERM_GRACE_MS, terminationGraceMs, } from './shell-termination.js';
+/** Stable internal error text returned when a shell invocation is cancelled. */
+const SHELL_TASK_CANCELLED_MESSAGE = 'Shell command cancelled';
+function isAbortSignal(value) {
+    // A structural check can admit a lookalike whose addEventListener throws
+    // after spawn, recreating the detached-child leak this validation prevents.
+    return value instanceof AbortSignal;
+}
 /**
  * Task that executes a shell command.
  *
@@ -30,9 +38,21 @@ export class ShellTask extends BaseTask {
         if (!this.options.command || typeof this.options.command !== 'string') {
             throw new Error('ShellTask requires a "command" option');
         }
+        if (this.options.signal !== undefined && !isAbortSignal(this.options.signal)) {
+            throw new Error('ShellTask "signal" must be an AbortSignal');
+        }
     }
     async execute() {
-        const { command, cwd, timeout = 300_000 } = this.options;
+        const { command, cwd, timeout = 300_000, signal } = this.options;
+        // Do this before creating the Promise (and, importantly, before spawn) so
+        // an already-cancelled run cannot launch a process at all.
+        if (signal?.aborted) {
+            return {
+                success: false,
+                error: new Error(SHELL_TASK_CANCELLED_MESSAGE),
+                data: { exitCode: null, signal: null, stderr: '', stdout: '' },
+            };
+        }
         return new Promise((resolve) => {
             // Cross-platform: route through the platform shell so command strings
             // like "npm run build" or "echo $HOME && ls" work the same way they
@@ -41,12 +61,36 @@ export class ShellTask extends BaseTask {
                 cwd,
                 shell: true,
                 stdio: ['ignore', 'pipe', 'pipe'],
+                // A signal-bearing POSIX invocation gets its own process group so its
+                // shell and ordinary descendants can be terminated together. Keep the
+                // legacy spawn behavior unchanged when no signal was supplied.
+                ...(signal && process.platform !== 'win32' ? { detached: true } : {}),
             });
             let stdoutBuf = '';
             let stderrBuf = '';
             let stdoutTail = '';
             let stderrTail = '';
-            let timedOut = false;
+            let terminalCause = 'running';
+            let settled = false;
+            let abortListenerRegistered = false;
+            let timeoutTimer;
+            let terminationTimer;
+            let escalationTimer;
+            let terminator;
+            let terminationEscalated = false;
+            let pendingTerminalClose;
+            const onStdoutData = (chunk) => {
+                stdoutBuf += chunk;
+                emitLines(chunk, 'stdout', (line) => {
+                    this.logger.info({ stream: 'stdout' }, line);
+                });
+            };
+            const onStderrData = (chunk) => {
+                stderrBuf += chunk;
+                emitLines(chunk, 'stderr', (line) => {
+                    this.logger.warn({ stream: 'stderr' }, line);
+                });
+            };
             const emitLines = (chunk, tailRef, emit) => {
                 // Maintain a small tail buffer so we never emit a partial line.
                 // Each newline we see flushes everything before it as one line;
@@ -65,65 +109,167 @@ export class ShellTask extends BaseTask {
             };
             child.stdout?.setEncoding('utf-8');
             child.stderr?.setEncoding('utf-8');
-            child.stdout?.on('data', (chunk) => {
-                stdoutBuf += chunk;
-                emitLines(chunk, 'stdout', (line) => {
-                    this.logger.info({ stream: 'stdout' }, line);
-                });
-            });
-            child.stderr?.on('data', (chunk) => {
-                stderrBuf += chunk;
-                emitLines(chunk, 'stderr', (line) => {
-                    this.logger.warn({ stream: 'stderr' }, line);
-                });
-            });
-            const timer = setTimeout(() => {
-                timedOut = true;
-                // SIGKILL on Windows is mapped to TerminateProcess by libuv.
-                child.kill('SIGKILL');
-            }, timeout);
+            child.stdout?.on('data', onStdoutData);
+            child.stderr?.on('data', onStderrData);
             const flushTails = () => {
                 if (stdoutTail.length > 0) {
                     this.logger.info({ stream: 'stdout' }, stdoutTail);
-                    stdoutBuf += stdoutTail;
                     stdoutTail = '';
                 }
                 if (stderrTail.length > 0) {
                     this.logger.warn({ stream: 'stderr' }, stderrTail);
-                    stderrBuf += stderrTail;
                     stderrTail = '';
                 }
             };
-            child.on('error', (err) => {
-                clearTimeout(timer);
+            const removeAbortListener = () => {
+                if (!abortListenerRegistered)
+                    return;
+                abortListenerRegistered = false;
+                signal?.removeEventListener('abort', onAbort);
+            };
+            const cleanup = () => {
+                if (timeoutTimer)
+                    clearTimeout(timeoutTimer);
+                if (terminationTimer)
+                    clearTimeout(terminationTimer);
+                if (escalationTimer)
+                    clearTimeout(escalationTimer);
+                removeAbortListener();
+                // A bounded fallback may settle before a misbehaving child closes.
+                // Stop capturing output then, while retaining the child error handler
+                // until Node finishes closing it.
+                child.stdout?.removeListener('data', onStdoutData);
+                child.stderr?.removeListener('data', onStderrData);
+                terminator?.dispose();
+            };
+            const resultData = (exitCode, exitSignal, includeSignal = true) => {
                 flushTails();
-                resolve({
+                return {
+                    exitCode,
+                    ...(includeSignal ? { signal: exitSignal } : {}),
+                    stderr: stderrBuf.trimEnd(),
+                    stdout: stdoutBuf.trimEnd(),
+                };
+            };
+            const settle = (result) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                resolve(result);
+            };
+            const settleTerminal = (exitCode, exitSignal) => {
+                const data = resultData(exitCode, exitSignal);
+                settle({
+                    success: false,
+                    error: new Error(terminalCause === 'cancelled'
+                        ? SHELL_TASK_CANCELLED_MESSAGE
+                        : `Shell command timed out after ${timeout}ms`),
+                    data,
+                });
+            };
+            const requestTermination = (cause) => {
+                if (settled || terminalCause !== 'running')
+                    return;
+                terminalCause = cause;
+                if (timeoutTimer)
+                    clearTimeout(timeoutTimer);
+                removeAbortListener();
+                // Preserve the legacy no-signal timeout path exactly: kill the shell
+                // and wait for close. The bounded cancellation contract applies only
+                // when a caller supplied an AbortSignal.
+                if (cause === 'timedOut' && !signal) {
+                    try {
+                        child.kill('SIGKILL');
+                    }
+                    catch {
+                        // The existing error/close handlers retain responsibility for the
+                        // final task result.
+                    }
+                    return;
+                }
+                try {
+                    terminator = beginShellTermination(child);
+                    terminator.onTreeKillComplete(() => {
+                        if (!pendingTerminalClose || settled || terminalCause === 'running')
+                            return;
+                        const pending = pendingTerminalClose;
+                        pendingTerminalClose = undefined;
+                        settleTerminal(pending.exitCode, pending.exitSignal);
+                    });
+                    if (terminator.platform !== 'win32') {
+                        escalationTimer = setTimeout(() => {
+                            terminationEscalated = true;
+                            terminator?.escalate();
+                            if (pendingTerminalClose) {
+                                const pending = pendingTerminalClose;
+                                pendingTerminalClose = undefined;
+                                settleTerminal(pending.exitCode, pending.exitSignal);
+                            }
+                        }, POSIX_SIGTERM_GRACE_MS);
+                    }
+                    terminationTimer = setTimeout(() => {
+                        terminator?.release();
+                        settleTerminal(null, null);
+                    }, terminationGraceMs(terminator.platform));
+                }
+                catch {
+                    // `close` or the bounded fallback below will settle the terminal
+                    // result; a kill race must not escape as an unhandled exception.
+                }
+            };
+            const onAbort = () => requestTermination('cancelled');
+            timeoutTimer = setTimeout(() => requestTermination('timedOut'), timeout);
+            signal?.addEventListener('abort', onAbort, { once: true });
+            abortListenerRegistered = Boolean(signal);
+            child.on('error', (err) => {
+                if (terminalCause !== 'running') {
+                    // Preserve the legacy no-signal timeout result if the kill itself
+                    // errors and no `close` follows. Without this, a timeout could leave
+                    // the task pending indefinitely; the original error and data shape
+                    // remain intact for compatibility.
+                    if (terminalCause === 'timedOut' && !signal) {
+                        settle({
+                            success: false,
+                            error: err instanceof Error ? err : new Error(String(err)),
+                            data: resultData(null, null, false),
+                        });
+                    }
+                    return;
+                }
+                settle({
                     success: false,
                     error: err instanceof Error ? err : new Error(String(err)),
-                    data: { exitCode: null, stderr: stderrBuf.trimEnd(), stdout: stdoutBuf.trimEnd() },
+                    data: resultData(null, null, Boolean(signal)),
                 });
             });
-            child.on('close', (code, signal) => {
-                clearTimeout(timer);
-                flushTails();
-                const trimmedOut = stdoutBuf.trimEnd();
-                const trimmedErr = stderrBuf.trimEnd();
-                if (timedOut) {
-                    resolve({
-                        success: false,
-                        error: new Error(`Shell command timed out after ${timeout}ms`),
-                        data: { exitCode: code, signal, stderr: trimmedErr, stdout: trimmedOut },
-                    });
+            child.on('close', (code, exitSignal) => {
+                if (settled)
+                    return;
+                if (terminalCause !== 'running') {
+                    const waitsForPosixEscalation = terminator !== undefined &&
+                        terminator.platform !== 'win32' &&
+                        !terminationEscalated;
+                    const waitsForWindowsTree = terminator?.platform === 'win32' && !terminator.isTreeKillComplete();
+                    if (waitsForPosixEscalation || waitsForWindowsTree) {
+                        // A root shell may close before its descendants are finished.
+                        // Keep the POSIX escalation or Windows taskkill operation owned
+                        // until it finishes or reaches the bounded terminal deadline.
+                        pendingTerminalClose = { exitCode: code, exitSignal };
+                        return;
+                    }
+                    settleTerminal(code, exitSignal);
                     return;
                 }
+                const data = resultData(code, exitSignal);
                 if (code === 0) {
-                    resolve({ success: true, data: { output: trimmedOut } });
+                    settle({ success: true, data: { output: data.stdout } });
                     return;
                 }
-                resolve({
+                settle({
                     success: false,
-                    error: new Error(`Shell command failed (exit ${code}): ${(trimmedErr || trimmedOut).trimEnd()}`),
-                    data: { exitCode: code, signal, stderr: trimmedErr, stdout: trimmedOut },
+                    error: new Error(`Shell command failed (exit ${code}): ${(data.stderr || data.stdout).trimEnd()}`),
+                    data,
                 });
             });
         });

package/dist/task/shell-task.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell-task.js","sourceRoot":"","sources":["../../src/task/shell-task.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shell-task.js","sourceRoot":"","sources":["../../src/task/shell-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAmB,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,GAEnB,MAAM,wBAAwB,CAAC;AAUhC,gFAAgF;AAChF,MAAM,4BAA4B,GAAG,yBAAyB,CAAC;AAE/D,SAAS,aAAa,CAAC,KAAc;IACnC,yEAAyE;IACzE,4EAA4E;IAC5E,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,SAAU,SAAQ,QAA0B;IACvD,IAAI,QAAQ;QACV,OAAO,SAAS,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACzC,CAAC;IAES,QAAQ;QAChB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7E,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAEjE,0EAA0E;QAC1E,2DAA2D;QAC3D,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,IAAI,KAAK,CAAC,4BAA4B,CAAC;gBAC9C,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;aAC/D,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,EAAE;YACzC,sEAAsE;YACtE,oEAAoE;YACpE,sBAAsB;YACtB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE;gBAC3B,GAAG;gBACH,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;gBACjC,sEAAsE;gBACtE,sEAAsE;gBACtE,+DAA+D;gBAC/D,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtE,CAAC,CAAC;YAEH,IAAI,SAAS,GAAG,EAAE,CAAC;YACnB,IAAI,SAAS,GAAG,EAAE,CAAC;YACnB,IAAI,UAAU,GAAG,EAAE,CAAC;YACpB,IAAI,UAAU,GAAG,EAAE,CAAC;YACpB,IAAI,aAAa,GAAyC,SAAS,CAAC;YACpE,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,IAAI,uBAAuB,GAAG,KAAK,CAAC;YACpC,IAAI,YAAuD,CAAC;YAC5D,IAAI,gBAA2D,CAAC;YAChE,IAAI,eAA0D,CAAC;YAC/D,IAAI,UAA8C,CAAC;YACnD,IAAI,oBAAoB,GAAG,KAAK,CAAC;YACjC,IAAI,oBAES,CAAC;YACd,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,EAAE;gBACrC,SAAS,IAAI,KAAK,CAAC;gBACnB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;oBAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;gBAC/C,CAAC,CAAC,CAAC;YACL,CAAC,CAAC;YACF,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,EAAE;gBACrC,SAAS,IAAI,KAAK,CAAC;gBACnB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;oBAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC;gBAC/C,CAAC,CAAC,CAAC;YACL,CAAC,CAAC;YAEF,MAAM,SAAS,GAAG,CAChB,KAAa,EACb,OAA4B,EAC5B,IAA4B,EAC5B,EAAE;gBACF,gEAAgE;gBAChE,gEAAgE;gBAChE,gDAAgD;gBAChD,MAAM,QAAQ,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC;gBAC1E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACtC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBACpC,IAAI,OAAO,KAAK,QAAQ;oBAAE,UAAU,GAAG,SAAS,CAAC;;oBAC5C,UAAU,GAAG,SAAS,CAAC;gBAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;wBAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC,CAAC;YAEF,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;YACnC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;YAEnC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YACvC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAEvC,MAAM,UAAU,GAAG,GAAG,EAAE;gBACtB,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,UAAU,CAAC,CAAC;oBACnD,UAAU,GAAG,EAAE,CAAC;gBAClB,CAAC;gBACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,UAAU,CAAC,CAAC;oBACnD,UAAU,GAAG,EAAE,CAAC;gBAClB,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,mBAAmB,GAAG,GAAG,EAAE;gBAC/B,IAAI,CAAC,uBAAuB;oBAAE,OAAO;gBACrC,uBAAuB,GAAG,KAAK,CAAC;gBAChC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAChD,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,IAAI,YAAY;oBAAE,YAAY,CAAC,YAAY,CAAC,CAAC;gBAC7C,IAAI,gBAAgB;oBAAE,YAAY,CAAC,gBAAgB,CAAC,CAAC;gBACrD,IAAI,eAAe;oBAAE,YAAY,CAAC,eAAe,CAAC,CAAC;gBACnD,mBAAmB,EAAE,CAAC;gBACtB,mEAAmE;gBACnE,sEAAsE;gBACtE,kCAAkC;gBAClC,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;gBACnD,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;gBACnD,UAAU,EAAE,OAAO,EAAE,CAAC;YACxB,CAAC,CAAC;YAEF,MAAM,UAAU,GAAG,CACjB,QAAuB,EACvB,UAAiC,EACjC,aAAa,GAAG,IAAI,EACpB,EAAE;gBACF,UAAU,EAAE,CAAC;gBACb,OAAO;oBACL,QAAQ;oBACR,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChD,MAAM,EAAE,SAAS,CAAC,OAAO,EAAE;oBAC3B,MAAM,EAAE,SAAS,CAAC,OAAO,EAAE;iBAC5B,CAAC;YACJ,CAAC,CAAC;YAEF,MAAM,MAAM,GAAG,CAAC,MAAkB,EAAE,EAAE;gBACpC,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC;YAEF,MAAM,cAAc,GAAG,CAAC,QAAuB,EAAE,UAAiC,EAAE,EAAE;gBACpF,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAC9C,MAAM,CAAC;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,IAAI,KAAK,CACd,aAAa,KAAK,WAAW;wBAC3B,CAAC,CAAC,4BAA4B;wBAC9B,CAAC,CAAC,iCAAiC,OAAO,IAAI,CACjD;oBACD,IAAI;iBACL,CAAC,CAAC;YACL,CAAC,CAAC;YAEF,MAAM,kBAAkB,GAAG,CAAC,KAA+B,EAAE,EAAE;gBAC7D,IAAI,OAAO,IAAI,aAAa,KAAK,SAAS;oBAAE,OAAO;gBACnD,aAAa,GAAG,KAAK,CAAC;gBACtB,IAAI,YAAY;oBAAE,YAAY,CAAC,YAAY,CAAC,CAAC;gBAC7C,mBAAmB,EAAE,CAAC;gBAEtB,qEAAqE;gBACrE,qEAAqE;gBACrE,yCAAyC;gBACzC,IAAI,KAAK,KAAK,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;oBACpC,IAAI,CAAC;wBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACxB,CAAC;oBAAC,MAAM,CAAC;wBACP,kEAAkE;wBAClE,qBAAqB;oBACvB,CAAC;oBACD,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC;oBACH,UAAU,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;oBAC1C,UAAU,CAAC,kBAAkB,CAAC,GAAG,EAAE;wBACjC,IAAI,CAAC,oBAAoB,IAAI,OAAO,IAAI,aAAa,KAAK,SAAS;4BAAE,OAAO;wBAC5E,MAAM,OAAO,GAAG,oBAAoB,CAAC;wBACrC,oBAAoB,GAAG,SAAS,CAAC;wBACjC,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;oBACvD,CAAC,CAAC,CAAC;oBACH,IAAI,UAAU,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;wBACpC,eAAe,GAAG,UAAU,CAAC,GAAG,EAAE;4BAChC,oBAAoB,GAAG,IAAI,CAAC;4BAC5B,UAAU,EAAE,QAAQ,EAAE,CAAC;4BACvB,IAAI,oBAAoB,EAAE,CAAC;gCACzB,MAAM,OAAO,GAAG,oBAAoB,CAAC;gCACrC,oBAAoB,GAAG,SAAS,CAAC;gCACjC,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;4BACvD,CAAC;wBACH,CAAC,EAAE,sBAAsB,CAAC,CAAC;oBAC7B,CAAC;oBACD,gBAAgB,GAAG,UAAU,CAAC,GAAG,EAAE;wBACjC,UAAU,EAAE,OAAO,EAAE,CAAC;wBACtB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBAC7B,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC9C,CAAC;gBAAC,MAAM,CAAC;oBACP,iEAAiE;oBACjE,iEAAiE;gBACnE,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;YAEtD,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;YAEzE,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAE1C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;oBAChC,kEAAkE;oBAClE,qEAAqE;oBACrE,mEAAmE;oBACnE,mCAAmC;oBACnC,IAAI,aAAa,KAAK,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;wBAC5C,MAAM,CAAC;4BACL,OAAO,EAAE,KAAK;4BACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;4BAC1D,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;yBACpC,CAAC,CAAC;oBACL,CAAC;oBACD,OAAO;gBACT,CAAC;gBACD,MAAM,CAAC;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBAC1D,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;iBAC9C,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE;gBACrC,IAAI,OAAO;oBAAE,OAAO;gBACpB,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;oBAChC,MAAM,uBAAuB,GAC3B,UAAU,KAAK,SAAS;wBACxB,UAAU,CAAC,QAAQ,KAAK,OAAO;wBAC/B,CAAC,oBAAoB,CAAC;oBACxB,MAAM,mBAAmB,GACvB,UAAU,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC;oBACvE,IAAI,uBAAuB,IAAI,mBAAmB,EAAE,CAAC;wBACnD,8DAA8D;wBAC9D,gEAAgE;wBAChE,8DAA8D;wBAC9D,oBAAoB,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;wBACtD,OAAO;oBACT,CAAC;oBACD,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;oBACjC,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAC1C,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBACzD,OAAO;gBACT,CAAC;gBACD,MAAM,CAAC;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,IAAI,KAAK,CACd,8BAA8B,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CACjF;oBACD,IAAI;iBACL,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/task/shell-termination.d.ts

@@ -0,0 +1,34 @@
+import { type ChildProcess, type SpawnOptions } from 'node:child_process';
+export declare const POSIX_SIGTERM_GRACE_MS = 250;
+export declare const POSIX_TERMINATION_GRACE_MS = 1000;
+export declare const WINDOWS_TERMINATION_GRACE_MS = 3000;
+type SpawnProcess = (command: string, args: readonly string[], options: SpawnOptions) => ChildProcess;
+export interface ShellTerminationDependencies {
+    platform?: NodeJS.Platform;
+    spawnProcess?: SpawnProcess;
+    killProcessGroup?: (pid: number, signal: NodeJS.Signals) => void;
+}
+export interface ShellTerminationHandle {
+    readonly platform: NodeJS.Platform;
+    /** Whether the Windows tree helper has finished or failed. */
+    isTreeKillComplete(): boolean;
+    /** Notify ShellTask when it is safe to combine tree and root completion. */
+    onTreeKillComplete(listener: () => void): void;
+    /** Escalate a cooperative POSIX stop, or force the Windows root/helper. */
+    escalate(): void;
+    /** Release handles after the bounded terminal deadline. */
+    release(): void;
+    /** Stop helper ownership after the shell has closed normally. */
+    dispose(): void;
+}
+export declare function terminationGraceMs(platform: NodeJS.Platform): number;
+/**
+ * Start termination for one shell invocation.
+ *
+ * This module is deliberately internal. Passing the platform and process
+ * functions as dependencies makes the policy testable on every CI platform
+ * without changing ShellTask's public API or relying on global mutable state.
+ */
+export declare function beginShellTermination(child: ChildProcess, dependencies?: ShellTerminationDependencies): ShellTerminationHandle;
+export {};
+//# sourceMappingURL=shell-termination.d.ts.map

package/dist/task/shell-termination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-termination.d.ts","sourceRoot":"","sources":["../../src/task/shell-termination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEjF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAChD,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAElD,KAAK,YAAY,GAAG,CAClB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,YAAY,KAClB,YAAY,CAAC;AAElB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,8DAA8D;IAC9D,kBAAkB,IAAI,OAAO,CAAC;IAC9B,4EAA4E;IAC5E,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC/C,2EAA2E;IAC3E,QAAQ,IAAI,IAAI,CAAC;IACjB,2DAA2D;IAC3D,OAAO,IAAI,IAAI,CAAC;IAChB,iEAAiE;IACjE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,YAAY,GAAE,4BAAiC,GAC9C,sBAAsB,CAyJxB"}