@sema-agent/core 1.279.0

package/dist/core/spec-contract.js

@@ -0,0 +1,256 @@
+import { execFile } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { lstatSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, resolve, sep } from "node:path";
+const DEFAULT_GATE_TIMEOUT_MS = 60_000;
+const GATE_MAX_BUFFER = 16 * 1024 * 1024;
+const OUTPUT_TAIL_CHARS = 1500;
+const REGEX_SCAN_CAP = 2 * 1024 * 1024;
+function execGate(gate, cwd, signal) {
+    return new Promise((resolvePromise) => {
+        execFile(gate.cmd[0], gate.cmd.slice(1), {
+            cwd,
+            timeout: gate.timeoutMs ?? DEFAULT_GATE_TIMEOUT_MS,
+            maxBuffer: GATE_MAX_BUFFER,
+            encoding: "utf8",
+            signal,
+        }, (err, stdout, stderr) => {
+            const output = (stdout ?? "") + (stderr ?? "");
+            if (!err)
+                return resolvePromise({ exitCode: 0, output });
+            const e = err;
+            if (typeof e.code === "number")
+                return resolvePromise({ exitCode: e.code, output });
+            if (e.killed || e.signal) {
+                return resolvePromise({ exitCode: null, output, infraError: `timeout/killed (${e.signal ?? "timeout"})` });
+            }
+            return resolvePromise({ exitCode: null, output, infraError: String(e.code ?? e.message ?? "spawn error") });
+        });
+    });
+}
+function safeTest(re, output) {
+    try {
+        return new RegExp(re).test(output);
+    }
+    catch {
+        return undefined;
+    }
+}
+function firstCount(re, output) {
+    let m;
+    try {
+        m = new RegExp(re).exec(output);
+    }
+    catch {
+        return undefined;
+    }
+    if (!m)
+        return undefined;
+    const n = Number(m[1] ?? m[0]);
+    return Number.isFinite(n) ? n : undefined;
+}
+function evaluateGate(gate, exec, baseline) {
+    const base = {
+        name: gate.name,
+        exitCode: exec.exitCode,
+        outputTail: exec.output.slice(-OUTPUT_TAIL_CHARS),
+    };
+    if (exec.infraError)
+        return { ...base, verdict: "error", reason: exec.infraError };
+    const green = gate.green ?? {};
+    const scanned = exec.output.length > REGEX_SCAN_CAP
+        ? `${exec.output.slice(0, REGEX_SCAN_CAP / 2)}\n…[${exec.output.length - REGEX_SCAN_CAP} bytes elided]…\n${exec.output.slice(-REGEX_SCAN_CAP / 2)}`
+        : exec.output;
+    const green_output = scanned;
+    let pass;
+    let fail;
+    if (green.parse) {
+        pass = firstCount(green.parse.passRe, green_output);
+        fail = firstCount(green.parse.failRe, green_output);
+        if (pass === undefined || fail === undefined) {
+            return { ...base, verdict: "error", reason: "parse: pass/fail counts not extractable from output" };
+        }
+    }
+    const failures = [];
+    const expectedExit = green.exitCode ?? (green.parse ? undefined : 0);
+    if (expectedExit !== undefined && exec.exitCode !== expectedExit) {
+        failures.push(`exitCode ${exec.exitCode} !== ${expectedExit}`);
+    }
+    if (green.mustMatch !== undefined) {
+        const m = safeTest(green.mustMatch, green_output);
+        if (m === undefined)
+            return { ...base, pass, fail, verdict: "error", reason: `mustMatch is not a valid regex: /${green.mustMatch}/` };
+        if (!m)
+            failures.push(`mustMatch /${green.mustMatch}/ not found`);
+    }
+    if (green.mustNotMatch !== undefined) {
+        const m = safeTest(green.mustNotMatch, green_output);
+        if (m === undefined)
+            return { ...base, pass, fail, verdict: "error", reason: `mustNotMatch is not a valid regex: /${green.mustNotMatch}/` };
+        if (m)
+            failures.push(`mustNotMatch /${green.mustNotMatch}/ matched`);
+    }
+    if (green.parse) {
+        if (fail !== 0)
+            failures.push(`fail count ${fail} !== 0`);
+        let minPass;
+        if (green.minPass === "baseline") {
+            if (baseline === undefined) {
+                minPass = undefined;
+            }
+            else {
+                const b = baseline[gate.name];
+                if (!b) {
+                    return { ...base, pass, fail, verdict: "error", reason: `minPass:"baseline" but no baseline captured for gate "${gate.name}"` };
+                }
+                minPass = b.pass + b.fail;
+            }
+        }
+        else {
+            minPass = green.minPass ?? 1;
+        }
+        if (minPass !== undefined && (pass ?? 0) < minPass)
+            failures.push(`pass count ${pass} < minPass ${minPass}`);
+    }
+    if (failures.length > 0)
+        return { ...base, pass, fail, verdict: "red", reason: failures.join("; ") };
+    return { ...base, pass, fail, verdict: "green" };
+}
+export async function runOracle(gates, cwdRoot, opts) {
+    const root = resolve(cwdRoot);
+    const results = [];
+    const err = (gate, reason) => ({
+        name: gate.name,
+        verdict: "error",
+        exitCode: null,
+        reason,
+        outputTail: "",
+    });
+    for (const gate of gates) {
+        if (!Array.isArray(gate.cmd) || gate.cmd.length === 0 || typeof gate.cmd[0] !== "string" || gate.cmd[0].length === 0) {
+            results.push(err(gate, "gate cmd is empty — no executable to run"));
+            continue;
+        }
+        let cwd = root;
+        if (gate.cwd !== undefined) {
+            const candidate = resolve(root, gate.cwd);
+            if (candidate !== root && !candidate.startsWith(root + sep)) {
+                results.push(err(gate, `gate cwd escapes the spec root: ${gate.cwd}`));
+                continue;
+            }
+            try {
+                const physRoot = realpathSync(root);
+                const phys = realpathSync(candidate);
+                if (phys !== physRoot && !phys.startsWith(physRoot + sep)) {
+                    results.push(err(gate, `gate cwd physically escapes the spec root (symlink): ${gate.cwd}`));
+                    continue;
+                }
+            }
+            catch {
+            }
+            cwd = candidate;
+        }
+        const exec = await execGate(gate, cwd, opts?.signal);
+        results.push(evaluateGate(gate, exec, opts?.baseline));
+    }
+    const verdict = results.some((r) => r.verdict === "error")
+        ? "error"
+        : results.some((r) => r.verdict === "red")
+            ? "red"
+            : "green";
+    return { verdict, gates: results };
+}
+export function captureBaseline(report) {
+    const baseline = {};
+    for (const g of report.gates) {
+        if (g.pass !== undefined && g.fail !== undefined)
+            baseline[g.name] = { pass: g.pass, fail: g.fail };
+    }
+    return baseline;
+}
+export function specError(code, message) {
+    const e = new Error(message);
+    e.code = code;
+    return e;
+}
+export function resolveFrozenPaths(rootDir, frozenPaths) {
+    const root = resolve(rootDir);
+    return frozenPaths.map((p) => {
+        if (isAbsolute(p) || p.split(/[\\/]/).includes("..")) {
+            throw specError("spec.frozen_path_invalid", `frozenPaths entries must be relative and ..-free: ${p}`);
+        }
+        const abs = resolve(root, p);
+        if (abs !== root && !abs.startsWith(root + sep)) {
+            throw specError("spec.frozen_path_invalid", `frozenPaths entry escapes the root after resolution: ${p}`);
+        }
+        return abs;
+    });
+}
+export function snapshotFrozenPaths(resolvedPaths) {
+    const snap = new Map();
+    for (const p of resolvedPaths) {
+        try {
+            if (!lstatSync(p).isFile()) {
+                throw specError("spec.frozen_path_invalid", `frozen path must be a regular file (no symlinks/dirs): ${p}`);
+            }
+            snap.set(p, readFileSync(p));
+        }
+        catch (e) {
+            if (e.code === "spec.frozen_path_invalid")
+                throw e;
+            throw specError("spec.frozen_missing", `frozen path does not exist or is unreadable: ${p}`);
+        }
+    }
+    return snap;
+}
+export function restoreFrozenPaths(snapshot, rootDir) {
+    const physRoot = rootDir !== undefined ? safeRealpath(resolve(rootDir)) : undefined;
+    let restored = 0;
+    for (const [p, bytes] of snapshot) {
+        let isRegular = false;
+        let current;
+        try {
+            isRegular = lstatSync(p).isFile();
+            current = isRegular ? readFileSync(p) : undefined;
+        }
+        catch {
+            current = undefined;
+        }
+        if (isRegular && current !== undefined && current.equals(bytes))
+            continue;
+        try {
+            if (physRoot !== undefined) {
+                const physParent = safeRealpath(dirname(p));
+                if (physParent === undefined || (physParent !== physRoot && !physParent.startsWith(physRoot + sep))) {
+                    continue;
+                }
+            }
+            if (!isRegular)
+                rmSync(p, { recursive: true, force: true });
+            restoreOneAtomic(p, bytes);
+            restored++;
+        }
+        catch {
+        }
+    }
+    return restored;
+}
+function restoreOneAtomic(p, bytes) {
+    const tmp = `${p}.sema-restore-${randomBytes(9).toString("hex")}`;
+    try {
+        writeFileSync(tmp, bytes, { flag: "wx" });
+        renameSync(tmp, p);
+    }
+    finally {
+        rmSync(tmp, { force: true });
+    }
+}
+function safeRealpath(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=spec-contract.js.map

package/dist/core/spec-contract.js.map

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

package/dist/core/strategy-store.d.ts

@@ -0,0 +1,25 @@
+export interface StoredStrategy {
+    id: string;
+    problem: string;
+    strategy: string;
+    confidence: number;
+    scope: string;
+    ts: string;
+    teacherModel?: string;
+    signature?: string;
+}
+export interface StrategyStore {
+    save(s: StoredStrategy): Promise<void> | void;
+    find(scope: string, query: string, limit: number): Promise<StoredStrategy[]> | StoredStrategy[];
+    prune?(scope: string, maxSize: number): Promise<void> | void;
+}
+export declare class InMemoryStrategyStore implements StrategyStore {
+    private readonly maxPerScope;
+    private byScope;
+    constructor(maxPerScope?: number);
+    save(s: StoredStrategy): void;
+    find(scope: string, query: string, limit: number): StoredStrategy[];
+    prune(scope: string, maxSize: number): void;
+    get size(): number;
+}
+//# sourceMappingURL=strategy-store.d.ts.map

package/dist/core/strategy-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-store.d.ts","sourceRoot":"","sources":["../../src/core/strategy-store.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAE7B,EAAE,EAAE,MAAM,CAAC;IAEX,OAAO,EAAE,MAAM,CAAC;IAEhB,QAAQ,EAAE,MAAM,CAAC;IAEjB,UAAU,EAAE,MAAM,CAAC;IAEnB,KAAK,EAAE,MAAM,CAAC;IAEd,EAAE,EAAE,MAAM,CAAC;IAEX,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAE5B,IAAI,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAE9C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC;IAEhG,KAAK,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9D;AAqCD,qBAAa,qBAAsB,YAAW,aAAa;IAE7C,OAAO,CAAC,QAAQ,CAAC,WAAW;IADxC,OAAO,CAAC,OAAO,CAAuC;gBACzB,WAAW,SAAM;IAE9C,IAAI,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI;IAqB7B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IAgBnE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAU3C,IAAI,IAAI,IAAI,MAAM,CAIjB;CACF"}

package/dist/core/strategy-store.js

@@ -0,0 +1,81 @@
+const STOP = new Set([
+    "the", "and", "for", "with", "from", "this", "that", "into", "your", "you", "are", "was", "were", "has",
+    "have", "had", "not", "but", "all", "any", "can", "use", "using", "via", "then", "than", "out", "get",
+    "got", "its", "it's", "their", "them", "they", "what", "when", "which", "who", "how", "why", "a", "an",
+    "of", "to", "in", "on", "is", "it", "or", "as", "at", "by", "be", "do", "if", "so", "no", "up", "we",
+]);
+function tokens(s) {
+    return s.toLowerCase().match(/[a-z0-9]+/g) ?? [];
+}
+function significant(s) {
+    return tokens(s).filter((t) => t.length >= 3 && !STOP.has(t));
+}
+function normalize(s) {
+    return s.trim().toLowerCase().replace(/\s+/g, " ");
+}
+function ageDays(tsISO) {
+    const t = new Date(tsISO).getTime();
+    if (Number.isNaN(t)) {
+        return Infinity;
+    }
+    return Math.max(0, Date.now() - t) / 86_400_000;
+}
+function score(s) {
+    return (s.confidence + 1) * (1 / (1 + ageDays(s.ts)));
+}
+export class InMemoryStrategyStore {
+    maxPerScope;
+    byScope = new Map();
+    constructor(maxPerScope = 100) {
+        this.maxPerScope = maxPerScope;
+    }
+    save(s) {
+        const arr = this.byScope.get(s.scope) ?? [];
+        const np = normalize(s.problem);
+        const ng = normalize(s.strategy);
+        const dup = arr.find((e) => normalize(e.problem) === np && normalize(e.strategy) === ng);
+        if (dup) {
+            dup.confidence = Number.isFinite(s.confidence) ? Math.max(dup.confidence, s.confidence) : dup.confidence;
+            dup.ts = s.ts;
+            dup.teacherModel = s.teacherModel ?? dup.teacherModel;
+        }
+        else {
+            arr.push(s);
+        }
+        if (arr.length > this.maxPerScope) {
+            arr.sort((a, b) => score(b) - score(a));
+            arr.length = this.maxPerScope;
+        }
+        this.byScope.set(s.scope, arr);
+    }
+    find(scope, query, limit) {
+        const arr = this.byScope.get(scope);
+        if (!arr || arr.length === 0) {
+            return [];
+        }
+        const qSig = significant(query);
+        if (qSig.length === 0) {
+            return [];
+        }
+        const matches = arr.filter((s) => {
+            const probTokens = new Set(tokens(s.problem));
+            return qSig.every((t) => probTokens.has(t));
+        });
+        return matches.sort((a, b) => score(b) - score(a)).slice(0, Math.max(0, Number.isFinite(limit) ? limit : 0));
+    }
+    prune(scope, maxSize) {
+        const arr = this.byScope.get(scope);
+        const n = Math.max(0, maxSize);
+        if (arr && arr.length > n) {
+            arr.sort((a, b) => score(b) - score(a));
+            arr.length = n;
+        }
+    }
+    get size() {
+        let n = 0;
+        for (const arr of this.byScope.values())
+            n += arr.length;
+        return n;
+    }
+}
+//# sourceMappingURL=strategy-store.js.map

package/dist/core/strategy-store.js.map

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

package/dist/core/stub-env.d.ts

@@ -0,0 +1,28 @@
+import { type ExecutionEnv, ExecutionError, FileError, type FileInfo, type Result } from "../internal/harness.js";
+export declare class StubExecutionEnv implements ExecutionEnv {
+    cwd: string;
+    constructor(cwd?: string);
+    private fsErr;
+    absolutePath(path: string): Promise<Result<string, FileError>>;
+    joinPath(): Promise<Result<string, FileError>>;
+    readTextFile(path: string): Promise<Result<string, FileError>>;
+    readTextLines(path: string): Promise<Result<string[], FileError>>;
+    readBinaryFile(path: string): Promise<Result<Uint8Array, FileError>>;
+    writeFile(path: string): Promise<Result<void, FileError>>;
+    appendFile(path: string): Promise<Result<void, FileError>>;
+    fileInfo(path: string): Promise<Result<FileInfo, FileError>>;
+    listDir(path: string): Promise<Result<FileInfo[], FileError>>;
+    canonicalPath(path: string): Promise<Result<string, FileError>>;
+    exists(path: string): Promise<Result<boolean, FileError>>;
+    createDir(path: string): Promise<Result<void, FileError>>;
+    remove(path: string): Promise<Result<void, FileError>>;
+    createTempDir(): Promise<Result<string, FileError>>;
+    createTempFile(): Promise<Result<string, FileError>>;
+    exec(): Promise<Result<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }, ExecutionError>>;
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=stub-env.d.ts.map

package/dist/core/stub-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-env.d.ts","sourceRoot":"","sources":["../../src/core/stub-env.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,cAAc,EACd,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,MAAM,EAEZ,MAAM,wBAAwB,CAAC;AAShC,qBAAa,gBAAiB,YAAW,YAAY;IACnD,GAAG,EAAE,MAAM,CAAC;gBAEA,GAAG,SAAM;IAIrB,OAAO,CAAC,KAAK;IAMb,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAG9D,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAG9C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAG9D,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC;IAGjE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAGpE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAOzD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAG1D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAG5D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC;IAG7D,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAG/D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAGzD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAGzD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAGtD,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAGnD,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAIpD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,cAAc,CAAC,CAAC;IAMvF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/core/stub-env.js

@@ -0,0 +1,61 @@
+import { ExecutionError, FileError, err, } from "../internal/harness.js";
+export class StubExecutionEnv {
+    cwd;
+    constructor(cwd = "/") {
+        this.cwd = cwd;
+    }
+    fsErr(path) {
+        return Promise.resolve(err(new FileError("not_supported", "filesystem is not available in this environment", path)));
+    }
+    absolutePath(path) {
+        return this.fsErr(path);
+    }
+    joinPath() {
+        return this.fsErr();
+    }
+    readTextFile(path) {
+        return this.fsErr(path);
+    }
+    readTextLines(path) {
+        return this.fsErr(path);
+    }
+    readBinaryFile(path) {
+        return this.fsErr(path);
+    }
+    writeFile(path) {
+        return this.fsErr(path);
+    }
+    appendFile(path) {
+        return this.fsErr(path);
+    }
+    fileInfo(path) {
+        return this.fsErr(path);
+    }
+    listDir(path) {
+        return this.fsErr(path);
+    }
+    canonicalPath(path) {
+        return this.fsErr(path);
+    }
+    exists(path) {
+        return this.fsErr(path);
+    }
+    createDir(path) {
+        return this.fsErr(path);
+    }
+    remove(path) {
+        return this.fsErr(path);
+    }
+    createTempDir() {
+        return this.fsErr();
+    }
+    createTempFile() {
+        return this.fsErr();
+    }
+    exec() {
+        return Promise.resolve(err(new ExecutionError("shell_unavailable", "shell execution is not available in this environment")));
+    }
+    async cleanup() {
+    }
+}
+//# sourceMappingURL=stub-env.js.map

package/dist/core/stub-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-env.js","sourceRoot":"","sources":["../../src/core/stub-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACd,SAAS,EAGT,GAAG,GACJ,MAAM,wBAAwB,CAAC;AAShC,MAAM,OAAO,gBAAgB;IAC3B,GAAG,CAAS;IAEZ,YAAY,GAAG,GAAG,GAAG;QACnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAEO,KAAK,CAAI,IAAa;QAC5B,OAAO,OAAO,CAAC,OAAO,CACpB,GAAG,CAAC,IAAI,SAAS,CAAC,eAAe,EAAE,iDAAiD,EAAE,IAAI,CAAC,CAAC,CAC7F,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,KAAK,CAAS,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,EAAU,CAAC;IAC9B,CAAC;IACD,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,KAAK,CAAS,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,KAAK,CAAW,IAAI,CAAC,CAAC;IACpC,CAAC;IACD,cAAc,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,KAAK,CAAa,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,KAAK,CAAO,IAAI,CAAC,CAAC;IAChC,CAAC;IAKD,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,KAAK,CAAO,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,KAAK,CAAW,IAAI,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,KAAK,CAAa,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,KAAK,CAAS,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,KAAK,CAAU,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,KAAK,CAAO,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,KAAK,CAAO,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,aAAa;QACX,OAAO,IAAI,CAAC,KAAK,EAAU,CAAC;IAC9B,CAAC;IACD,cAAc;QACZ,OAAO,IAAI,CAAC,KAAK,EAAU,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,OAAO,OAAO,CAAC,OAAO,CACpB,GAAG,CAAC,IAAI,cAAc,CAAC,mBAAmB,EAAE,sDAAsD,CAAC,CAAC,CACrG,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO;IAEb,CAAC;CACF"}

package/dist/core/task-notification.d.ts

@@ -0,0 +1,56 @@
+export type TaskNotificationStatus = "completed" | "failed" | "killed" | "cancelled" | "event";
+export type SystemInjectionPriority = "now" | "next" | "later";
+export interface TaskNotificationPayload {
+    task_id: string;
+    task_type: "background_bash" | "workflow" | "background_agent" | "monitor";
+    toolUseId?: string;
+    status: TaskNotificationStatus;
+    lines?: string[];
+    seq?: number;
+    stoppedBy?: "user" | "parent" | "system" | (string & {});
+    summary: string;
+    result?: string;
+    output_file?: string;
+    usage?: unknown;
+    sessionId?: string;
+    recentSteps?: import("../agents/subagent-steps.js").SubagentStep[];
+    editedFiles?: import("../agents/subagent-steps.js").SubagentEditedFile[];
+    resumable?: boolean;
+}
+export interface SystemInjection<TPayload = unknown> {
+    kind: "task_notification";
+    priority: SystemInjectionPriority;
+    dedupKey: string;
+    payload: TPayload;
+}
+export declare function taskNotificationDedupKey(n: Pick<TaskNotificationPayload, "task_id" | "status" | "seq">): string;
+export declare function renderTaskNotificationXml(n: TaskNotificationPayload): string;
+export declare const MAX_PENDING_EVENTS_PER_TASK = 50;
+export declare const MAX_PENDING_EVENTS_PER_SESSION = 200;
+export declare const MAX_PENDING_SESSIONS = 100;
+export interface DrainedPendingNotifications {
+    items: TaskNotificationPayload[];
+    dropped: Map<string, {
+        count: number;
+        taskType: TaskNotificationPayload["task_type"];
+    }>;
+}
+export declare class PendingSessionNotifications {
+    private readonly sessions;
+    droppedSessions: number;
+    pend(sessionId: string, n: TaskNotificationPayload): void;
+    drain(sessionId: string): DrainedPendingNotifications | undefined;
+    get size(): number;
+}
+export declare function discloseDroppedPending(drained: DrainedPendingNotifications): TaskNotificationPayload[];
+export declare class SystemInjectionQueue<TPayload = TaskNotificationPayload> {
+    private readonly queues;
+    private readonly dedup;
+    private readonly listeners;
+    droppedOldest: number;
+    enqueue(item: SystemInjection<TPayload>): boolean;
+    drain(priority?: SystemInjectionPriority): Array<SystemInjection<TPayload>>;
+    subscribe(listener: (item: SystemInjection<TPayload>) => void): () => void;
+    get size(): number;
+}
+//# sourceMappingURL=task-notification.d.ts.map

package/dist/core/task-notification.d.ts.map

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