@sema-ai/core 1.275.1

package/dist/core/strategy-store.js

@@ -0,0 +1,100 @@
+/**
+ * Teacher-mode strategy repository (design/14). Stores the *generalized* strategies a teacher gave
+ * that actually worked, so a later similar problem can be solved without re-consulting the teacher
+ * (Inter-Cascade cross-session reuse). Retrieval is deliberately **high-precision / low-recall**: a
+ * wrong strategy injected into a student costs wasted turns + a likely escalation (net negative),
+ * while a missed strategy just falls back to asking the teacher (baseline). `scope` is a **mandatory
+ * isolation boundary** (multi-tenant: one user's strategies must never leak to another).
+ */
+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",
+]);
+/** Lowercased word tokens. */
+function tokens(s) {
+    return s.toLowerCase().match(/[a-z0-9]+/g) ?? [];
+}
+/** Meaningful tokens: ≥3 chars and not a stopword. */
+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; // a malformed timestamp scores ~0 (evicted first) rather than poisoning the sort with NaN
+    }
+    return Math.max(0, Date.now() - t) / 86_400_000;
+}
+/** Ranking score: confidence weighted by recency (no `uses` — avoids a reinforcement feedback loop). */
+function score(s) {
+    return (s.confidence + 1) * (1 / (1 + ageDays(s.ts)));
+}
+/**
+ * Default in-memory store. Retrieval: a stored problem must contain **every significant** query token
+ * (and there must be ≥1) — near-exact on the meaningful words, ignoring stopword noise. High precision
+ * by design. Ranked by `confidence × recency`. Per-scope capacity cap with eviction on save.
+ */
+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) {
+            // Guard against a NaN confidence poisoning the stored entry (→ NaN score → corrupt sort for the whole scope).
+            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);
+        }
+        // Evict the lowest-scoring when over capacity.
+        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 []; // nothing meaningful to match on → don't inject random strategies
+        }
+        const matches = arr.filter((s) => {
+            const probTokens = new Set(tokens(s.problem));
+            return qSig.every((t) => probTokens.has(t)); // every significant query token present in the problem
+        });
+        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); // a negative maxSize would throw RangeError on `arr.length = n`
+        if (arr && arr.length > n) {
+            arr.sort((a, b) => score(b) - score(a));
+            arr.length = n;
+        }
+    }
+    /** Total stored strategies (across scopes); for tests/observability. */
+    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,35 @@
+import { type ExecutionEnv, ExecutionError, FileError, type FileInfo, type Result } from "../internal/harness.js";
+/**
+ * A no-op ExecutionEnv for tool/MCP-only deployments (no shell, no filesystem).
+ *
+ * AgentHarness requires an `env`, but the normal tools+MCP code path never touches it.
+ * Every filesystem op returns a `not_supported` FileError; `exec` returns `shell_unavailable`.
+ * If a task genuinely needs shell/fs, supply a real ExecutionEnv instead (e.g. a Node or SSH one).
+ */
+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;AAEhC;;;;;;GAMG;AACH,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;IAGzD,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,69 @@
+import { ExecutionError, FileError, err, } from "../internal/harness.js";
+/**
+ * A no-op ExecutionEnv for tool/MCP-only deployments (no shell, no filesystem).
+ *
+ * AgentHarness requires an `env`, but the normal tools+MCP code path never touches it.
+ * Every filesystem op returns a `not_supported` FileError; `exec` returns `shell_unavailable`.
+ * If a task genuinely needs shell/fs, supply a real ExecutionEnv instead (e.g. a Node or SSH one).
+ */
+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() {
+        // nothing to release
+    }
+}
+//# 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;AAEhC;;;;;;GAMG;AACH,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;IACD,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;QACX,qBAAqB;IACvB,CAAC;CACF"}

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

@@ -0,0 +1,115 @@
+/** design/135 G2: `"event"` is the ONE non-terminal member — a Monitor batch notification (new stdout
+ *  lines from a still-running watch). Everything else is a terminal completion notification. */
+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;
+    /** design/135 G2 (Monitor): the batched stdout lines of ONE `status:"event"` notification (lines that
+     *  arrived within the same batch window). `result` carries the same text joined/clipped for the model;
+     *  this structured mirror is for SDK/UI consumers. */
+    lines?: string[];
+    /** design/135 G2 (Monitor): per-task monotonically increasing batch counter. Load-bearing for dedup —
+     *  {@link taskNotificationDedupKey} folds it in, so successive event batches (same task_id+status)
+     *  don't collapse into one queue entry. Terminal notifications omit it (one per status, as before). */
+    seq?: number;
+    /** design/134 §3.3: only on `status:"killed"` — who stopped it. MIRROR of task-registry `StopSource`
+     *  (the single source; inlined here to avoid an import cycle — task-registry imports this module;
+     *  third mirror: types.ts `BackgroundChildEvent.stoppedBy` — keep all three in sync). OPEN ENUM:
+     *  consumers must tolerate unknown values (a future "timeout" etc. is not breaking) and fall back
+     *  to default copy. */
+    stoppedBy?: "user" | "parent" | "system" | (string & {});
+    summary: string;
+    result?: string;
+    output_file?: string;
+    usage?: unknown;
+    /** 黑板 [428]b — the child run's SESSION id, when known. A shell keys its fleet/footer rows by its own
+     *  local ids; the a* task_id alone can be unmappable on its side — sessionId is the stable cross-system
+     *  anchor (the same handle TaskResult.sessionId / fleet rows carry). Optional: bash lane has none. */
+    sessionId?: string;
+    /** 黑板 [558] A — the child's last ≤10 completed tool steps, so the parent can write a precise resume
+     *  prompt for a killed/stopped child without reading the transcript. Rendered as a compact block.
+     *  Background-agent lane only; bounded upstream. */
+    recentSteps?: import("../agents/subagent-steps.js").SubagentStep[];
+    /** 黑板 [558] D (core half) — files the child mutated with edit counts. Background-agent lane only. */
+    editedFiles?: import("../agents/subagent-steps.js").SubagentEditedFile[];
+    /** 黑板 [558] E — `true` when the child can be revived via SendMessage (retained + not user-stopped).
+     *  Lets the parent decide continue-vs-restart without trial-and-error. Background-agent lane only. */
+    resumable?: boolean;
+}
+export interface SystemInjection<TPayload = unknown> {
+    kind: "task_notification";
+    /** design/116 §7 — priority is ENFORCED at the runner's subscribe listener (runtask.ts): now/next →
+     *  harness.steer() (next turn boundary, mid-work), later → harness.followUp() (only when the agent
+     *  would otherwise stop). CC's Sleep-gated later-drain is N/A (Sleep retired, design/136 §2.2). A
+     *  delivery that races the agent going idle parks on PendingSessionNotifications for the session's
+     *  next run ([492]②/[496]④). `drain()` serves that parked lane. */
+    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;
+/**
+ * 飞轮 [492]② / 黑板 [494]② — the BETWEEN-TURNS pending lane. A task notification born while NO turn is
+ * live (the run's notification lane is torn down, or the harness rejected the injection because the agent
+ * was already idle) used to be silently unreachable: the Monitor main use-case (long-watch events between
+ * turns) and the [496]④ stoppedBy notifications (a killed-evicted child whose registry row is already gone)
+ * both land exactly in that window. This store parks them PER SESSION; the session's next run drains it at
+ * start and rides the payloads down the SAME notification lane (steer at the next turn boundary), so
+ * in-turn and between-turn events keep one shape.
+ *
+ * Bounds (1.254 F4 家族纪律): per-task cap + per-session cap + session-count cap, oldest dropped first —
+ * preferring NON-terminal victims (an exit/killed terminal is the single most load-bearing notification of
+ * a watch and dies only when nothing else can) — and every drop is counted per task and DISCLOSED on
+ * delivery ({@link discloseDroppedPending}), never silent.
+ *
+ * NOT checkpointed (durable-resume ruling, recorded): the registry itself (`defaultTaskRegistry`) is
+ * process-local — a cross-process durable resume cannot reconnect a monitor's watcher/process anyway, so a
+ * pending queue that outlives the process would advertise events for handles that no longer exist. Same-
+ * process resume legs share this store via the Runner and drain normally.
+ */
+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 {
+    /** Chronological (pend order) payloads still held when the session's next run drained. */
+    items: TaskNotificationPayload[];
+    /** task_id → notifications evicted by the bounds while pending (never delivered). `taskType` remembers
+     *  the victim's lane so a survivors-none disclosure can still render an honest synthetic payload. */
+    dropped: Map<string, {
+        count: number;
+        taskType: TaskNotificationPayload["task_type"];
+    }>;
+}
+export declare class PendingSessionNotifications {
+    private readonly sessions;
+    /** Whole sessions evicted by {@link MAX_PENDING_SESSIONS} (their pendings were never delivered). */
+    droppedSessions: number;
+    pend(sessionId: string, n: TaskNotificationPayload): void;
+    /** Remove and return the session's pendings (one-shot — the next run consumes them exactly once). */
+    drain(sessionId: string): DrainedPendingNotifications | undefined;
+    get size(): number;
+}
+/**
+ * Delivery-side overflow disclosure: fold the per-task drop counts into the drained payloads. The first
+ * surviving payload of a task that lost events gets a `[task_id]`-prefixed disclosure line prepended to its
+ * summary (backgroundTasks 同规: the id keeps the loss addressable via TaskOutput). A task whose EVERY
+ * pending item was evicted still gets one honest synthetic `event` payload saying so — a fully silent loss
+ * is never allowed.
+ */
+export declare function discloseDroppedPending(drained: DrainedPendingNotifications): TaskNotificationPayload[];
+export declare class SystemInjectionQueue<TPayload = TaskNotificationPayload> {
+    private readonly queues;
+    private readonly dedup;
+    private readonly listeners;
+    /** F4 observability: how many queued items were evicted by the retention cap (never delivered). */
+    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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"}

package/dist/core/task-notification.js

@@ -0,0 +1,247 @@
+import { sanitizeUntrustedText } from "./untrusted-text.js";
+const TASK_NOTIFICATION_TAGS = [
+    "task-notification",
+    "task-id",
+    "task-type",
+    "tool-use-id",
+    "status",
+    "summary",
+    "result",
+    "output-file",
+    "usage",
+    "session-id",
+    "recent-steps",
+    "edited-files",
+    "resumable",
+];
+/** 黑板 [558] A/D — render the residual (recent steps + edited files) as a compact model-facing block. */
+function renderResidual(n) {
+    const lines = [];
+    if (n.recentSteps && n.recentSteps.length > 0) {
+        lines.push(...n.recentSteps.map((s) => `- ${s.tool}${s.target ? ` ${s.target}` : ""}${s.outcome ? ` → ${s.outcome}` : ""}`));
+    }
+    if (n.editedFiles && n.editedFiles.length > 0) {
+        lines.push(`edited: ${n.editedFiles.map((f) => `${f.path}${f.edits > 1 ? ` (×${f.edits})` : ""}`).join(", ")}`);
+    }
+    return lines.length > 0 ? lines.join("\n") : undefined;
+}
+function tag(name, value) {
+    const text = sanitizeUntrustedText(String(value), TASK_NOTIFICATION_TAGS)
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+    return `<${name}>${text}</${name}>`;
+}
+export function taskNotificationDedupKey(n) {
+    // design/135 G2: a Monitor event stream emits MANY notifications under the same task_id+status — the
+    // per-batch `seq` keeps each one's key unique (without it, batch #2 would be silently dedup-dropped
+    // while batch #1 sits undrained in the queue).
+    return `task_notification:${n.task_id}:${n.status}${n.seq !== undefined ? `:${n.seq}` : ""}`;
+}
+export function renderTaskNotificationXml(n) {
+    const usage = n.usage === undefined
+        ? undefined
+        : (() => {
+            try {
+                return JSON.stringify(n.usage);
+            }
+            catch {
+                return undefined;
+            }
+        })();
+    return [
+        "<task-notification>",
+        tag("task-id", n.task_id),
+        tag("task-type", n.task_type),
+        ...(n.toolUseId !== undefined ? [tag("tool-use-id", n.toolUseId)] : []),
+        tag("status", n.status),
+        tag("summary", n.summary),
+        ...(n.result !== undefined ? [tag("result", n.result)] : []),
+        ...(n.output_file !== undefined ? [tag("output-file", n.output_file)] : []),
+        ...(n.sessionId !== undefined ? [tag("session-id", n.sessionId)] : []),
+        ...(usage !== undefined ? [tag("usage", usage)] : []),
+        ...(() => {
+            const residual = renderResidual(n);
+            return residual !== undefined ? [tag("recent-steps", residual)] : [];
+        })(),
+        ...(n.resumable !== undefined ? [tag("resumable", n.resumable)] : []),
+        "</task-notification>",
+    ].join("\n");
+}
+/** codex 1.254 F4 bounds — a Monitor event stream can enqueue THOUSANDS of unique-keyed notifications per
+ *  task; nothing in production ever called drain(), so both the priority queues and the dedup set grew
+ *  without bound. Per-priority retention cap (oldest dropped + counted) and a dedup-key cap (insertion-order
+ *  eviction ≈ TTL: old keys age out; a re-enqueue of an evicted TERMINAL key is impossible in practice
+ *  because the producer fires each terminal exactly once). */
+const MAX_QUEUED_PER_PRIORITY = 200;
+const MAX_DEDUP_KEYS = 2_000;
+/**
+ * 飞轮 [492]② / 黑板 [494]② — the BETWEEN-TURNS pending lane. A task notification born while NO turn is
+ * live (the run's notification lane is torn down, or the harness rejected the injection because the agent
+ * was already idle) used to be silently unreachable: the Monitor main use-case (long-watch events between
+ * turns) and the [496]④ stoppedBy notifications (a killed-evicted child whose registry row is already gone)
+ * both land exactly in that window. This store parks them PER SESSION; the session's next run drains it at
+ * start and rides the payloads down the SAME notification lane (steer at the next turn boundary), so
+ * in-turn and between-turn events keep one shape.
+ *
+ * Bounds (1.254 F4 家族纪律): per-task cap + per-session cap + session-count cap, oldest dropped first —
+ * preferring NON-terminal victims (an exit/killed terminal is the single most load-bearing notification of
+ * a watch and dies only when nothing else can) — and every drop is counted per task and DISCLOSED on
+ * delivery ({@link discloseDroppedPending}), never silent.
+ *
+ * NOT checkpointed (durable-resume ruling, recorded): the registry itself (`defaultTaskRegistry`) is
+ * process-local — a cross-process durable resume cannot reconnect a monitor's watcher/process anyway, so a
+ * pending queue that outlives the process would advertise events for handles that no longer exist. Same-
+ * process resume legs share this store via the Runner and drain normally.
+ */
+export const MAX_PENDING_EVENTS_PER_TASK = 50;
+export const MAX_PENDING_EVENTS_PER_SESSION = 200;
+export const MAX_PENDING_SESSIONS = 100;
+const TERMINAL_STATUSES = new Set(["completed", "failed", "killed", "cancelled"]);
+export class PendingSessionNotifications {
+    sessions = new Map();
+    /** Whole sessions evicted by {@link MAX_PENDING_SESSIONS} (their pendings were never delivered). */
+    droppedSessions = 0;
+    pend(sessionId, n) {
+        let s = this.sessions.get(sessionId);
+        if (s === undefined) {
+            if (this.sessions.size >= MAX_PENDING_SESSIONS) {
+                // insertion-order eviction (≈ oldest-idle session goes first); counted, not silent
+                const oldest = this.sessions.keys().next().value;
+                if (oldest !== undefined) {
+                    this.sessions.delete(oldest);
+                    this.droppedSessions += 1;
+                }
+            }
+            s = { items: [], dropped: new Map() };
+            this.sessions.set(sessionId, s);
+        }
+        s.items.push(n);
+        let mine = 0;
+        for (const i of s.items)
+            if (i.task_id === n.task_id)
+                mine += 1;
+        if (mine > MAX_PENDING_EVENTS_PER_TASK)
+            evictOldest(s, (i) => i.task_id === n.task_id);
+        if (s.items.length > MAX_PENDING_EVENTS_PER_SESSION)
+            evictOldest(s, () => true);
+    }
+    /** Remove and return the session's pendings (one-shot — the next run consumes them exactly once). */
+    drain(sessionId) {
+        const s = this.sessions.get(sessionId);
+        if (s !== undefined)
+            this.sessions.delete(sessionId);
+        return s;
+    }
+    get size() {
+        return this.sessions.size;
+    }
+}
+/** Drop the OLDEST matching item, preferring a non-terminal (`event`) victim over a terminal one. */
+function evictOldest(s, match) {
+    let idx = s.items.findIndex((i) => match(i) && !TERMINAL_STATUSES.has(i.status));
+    if (idx === -1)
+        idx = s.items.findIndex(match);
+    if (idx === -1)
+        return;
+    const victim = s.items.splice(idx, 1)[0];
+    const prior = s.dropped.get(victim.task_id);
+    s.dropped.set(victim.task_id, { count: (prior?.count ?? 0) + 1, taskType: victim.task_type });
+}
+/**
+ * Delivery-side overflow disclosure: fold the per-task drop counts into the drained payloads. The first
+ * surviving payload of a task that lost events gets a `[task_id]`-prefixed disclosure line prepended to its
+ * summary (backgroundTasks 同规: the id keeps the loss addressable via TaskOutput). A task whose EVERY
+ * pending item was evicted still gets one honest synthetic `event` payload saying so — a fully silent loss
+ * is never allowed.
+ */
+export function discloseDroppedPending(drained) {
+    if (drained.dropped.size === 0)
+        return drained.items;
+    const disclosed = new Set();
+    const out = drained.items.map((n) => {
+        const dropped = drained.dropped.get(n.task_id);
+        if (dropped === undefined || disclosed.has(n.task_id))
+            return n;
+        disclosed.add(n.task_id);
+        return {
+            ...n,
+            summary: `[${n.task_id}] ${dropped.count} earlier pending notification(s) from this task were dropped (pending-queue overflow). ${n.summary}`,
+        };
+    });
+    for (const [taskId, dropped] of drained.dropped) {
+        if (disclosed.has(taskId))
+            continue;
+        out.push({
+            task_id: taskId,
+            task_type: dropped.taskType,
+            status: "event",
+            summary: `[${taskId}] ${dropped.count} pending notification(s) from this task were dropped (pending-queue overflow) before this turn; nothing else from it survived. TaskOutput("${taskId}") may still serve its spool.`,
+        });
+    }
+    return out;
+}
+export class SystemInjectionQueue {
+    queues = {
+        now: [],
+        next: [],
+        later: [],
+    };
+    dedup = new Set();
+    listeners = new Set();
+    /** F4 observability: how many queued items were evicted by the retention cap (never delivered). */
+    droppedOldest = 0;
+    enqueue(item) {
+        if (this.dedup.has(item.dedupKey))
+            return false;
+        this.dedup.add(item.dedupKey);
+        // Bound the dedup set (F4): evict oldest-inserted keys past the cap. The key must OUTLIVE delivery
+        // (it is what suppresses a duplicate re-enqueue of the same terminal notification), so it is never
+        // deleted on the delivered path — only drained items (below) and cap evictions release keys.
+        if (this.dedup.size > MAX_DEDUP_KEYS) {
+            for (const k of this.dedup) {
+                this.dedup.delete(k);
+                if (this.dedup.size <= MAX_DEDUP_KEYS)
+                    break;
+            }
+        }
+        // codex 1.254 F4 (delivery-is-the-drain): with a subscriber attached (the runtask lane subscribes
+        // BEFORE any producer is wired), enqueue==delivery — retaining a second copy in the queue was the
+        // unbounded growth, since the production path never calls drain(). Deliver and do NOT retain.
+        if (this.listeners.size > 0) {
+            for (const listener of this.listeners)
+                listener(item);
+            return true;
+        }
+        // No subscriber (tests / future priority-ordered drain path): retain, bounded per priority lane.
+        const q = this.queues[item.priority];
+        q.push(item);
+        if (q.length > MAX_QUEUED_PER_PRIORITY) {
+            const evicted = q.shift();
+            this.dedup.delete(evicted.dedupKey);
+            this.droppedOldest += 1;
+        }
+        return true;
+    }
+    drain(priority) {
+        const priorities = priority ? [priority] : ["now", "next", "later"];
+        const out = [];
+        for (const p of priorities) {
+            const q = this.queues[p];
+            while (q.length > 0) {
+                const item = q.shift();
+                this.dedup.delete(item.dedupKey);
+                out.push(item);
+            }
+        }
+        return out;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    get size() {
+        return this.queues.now.length + this.queues.next.length + this.queues.later.length;
+    }
+}
+//# sourceMappingURL=task-notification.js.map

package/dist/core/task-notification.js.map

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