@with-logic/elwood 0.1.3 → 0.2.0

package/dist/core/warnings/update.d.ts

@@ -4,7 +4,10 @@
  * when the installed CLI is compatible) and surfaced as this live warning with the diagnostics
  * the PRD allows — the installed version in use, the update probe's errno, and the updater's own
  * stderr capped at 2 KB in `raw` (the CLI updater's output, never session transcripts or
- * prompts).
+ * prompts). Contention is not a failed update and reports differently: an error carrying
+ * `updateReason: "active_owner"` — another process held the update lease until this caller's
+ * wait expired — becomes `errorCode: "update_active"` with a message saying the update was
+ * skipped, and no diagnostics, because no local updater ran to produce an errno or stderr.
  */
 import type { ElwoodAgentKind } from "../activity/index.ts";
 import type { AgentUpdateFailedWarning } from "./lifecycle.ts";
@@ -20,6 +23,12 @@ export type UpdateFailedWarning = Omit<AgentUpdateFailedWarning, "elwoodSessionI
  * Build the warning from the contained update error. `installedVersion` is the parsed version the
  * session will actually run (the preflight re-read it after the failed update). `errorCode` is the
  * update probe's allowlisted `errno` (e.g. `ETIMEDOUT`) when present, else a generic token.
+ *
+ * An error carrying `updateReason: "active_owner"` is contention, not failure: another process
+ * held the update lease until this caller's wait expired, so no local update command ran. That
+ * yields `errorCode: "update_active"` and a message saying the update was skipped, with empty
+ * diagnostics — there is no errno or updater stderr to report, and retrying is the caller's
+ * next startup, not something to drive off this warning.
  */
-export declare function updateFailedWarning(agent: ElwoodAgentKind, installedVersion: string, error: unknown): UpdateFailedWarning;
+export declare function buildUpdateWarning(agent: ElwoodAgentKind, installedVersion: string, error: unknown): UpdateFailedWarning;
 //# sourceMappingURL=update.d.ts.map

package/dist/core/warnings/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/core/warnings/update.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;AAEhG,2FAA2F;AAC3F,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,wBAAwB,EAAE,iBAAiB,CAAC,CAAC;AAMpF;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,EACtB,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,OAAO,GACb,mBAAmB,CAcrB"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/core/warnings/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;AAEhG,2FAA2F;AAC3F,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,wBAAwB,EAAE,iBAAiB,CAAC,CAAC;AAkBpF;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,OAAO,GACb,mBAAmB,CAkBrB"}

package/dist/core/warnings/update.js

@@ -4,29 +4,52 @@
  * when the installed CLI is compatible) and surfaced as this live warning with the diagnostics
  * the PRD allows — the installed version in use, the update probe's errno, and the updater's own
  * stderr capped at 2 KB in `raw` (the CLI updater's output, never session transcripts or
- * prompts).
+ * prompts). Contention is not a failed update and reports differently: an error carrying
+ * `updateReason: "active_owner"` — another process held the update lease until this caller's
+ * wait expired — becomes `errorCode: "update_active"` with a message saying the update was
+ * skipped, and no diagnostics, because no local updater ran to produce an errno or stderr.
  */
 import { ElwoodError } from "../errors.js";
 // Cap on the stderr carried in the warning's `raw`, so a hostile/verbose updater cannot flood a
 // warning payload. The probe layer already bounds captured output; this is a second, tighter cap.
 const maxStderr = 2_000;
+/**
+ * Reasons an update was skipped rather than attempted, and how each reads to a user. A
+ * skipped update carries no errno or updater stderr, because no local updater ran. Both
+ * reach the consumer as `errorCode: "update_active"` and differ only in timing:
+ * `active_owner` follows the full 60-second contention wait, while `cleanup_pending` is
+ * immediate, because a surviving updater group may outlive any bound worth waiting out.
+ */
+const skippedUpdates = new Map([
+    ["active_owner", "another updater is still active"],
+    ["cleanup_pending", "another updater's process group has not exited"],
+]);
 /**
  * Build the warning from the contained update error. `installedVersion` is the parsed version the
  * session will actually run (the preflight re-read it after the failed update). `errorCode` is the
  * update probe's allowlisted `errno` (e.g. `ETIMEDOUT`) when present, else a generic token.
+ *
+ * An error carrying `updateReason: "active_owner"` is contention, not failure: another process
+ * held the update lease until this caller's wait expired, so no local update command ran. That
+ * yields `errorCode: "update_active"` and a message saying the update was skipped, with empty
+ * diagnostics — there is no errno or updater stderr to report, and retrying is the caller's
+ * next startup, not something to drive off this warning.
  */
-export function updateFailedWarning(agent, installedVersion, error) {
+export function buildUpdateWarning(agent, installedVersion, error) {
     const details = error instanceof ElwoodError ? error.details : {};
     const errno = typeof details["errno"] === "string" ? details["errno"] : undefined;
     const stderr = typeof details["stderr"] === "string" ? details["stderr"] : "";
+    const skipped = skippedUpdates.get(details["updateReason"]);
     return {
         agent,
         source: "lifecycle",
         code: "agent_update_failed",
         severity: "warning",
-        message: `\`${agent} update\` failed; continuing with the installed CLI ${installedVersion}.`,
+        message: skipped === undefined
+            ? `\`${agent} update\` failed; continuing with the installed CLI ${installedVersion}.`
+            : `\`${agent} update\` skipped: ${skipped}; continuing with the installed CLI ${installedVersion}.`,
         installedVersion,
-        errorCode: errno ?? "update_failed",
+        errorCode: skipped === undefined ? (errno ?? "update_failed") : "update_active",
         raw: stderr.slice(0, maxStderr),
     };
 }

package/dist/core/warnings/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/core/warnings/update.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,gGAAgG;AAChG,kGAAkG;AAClG,MAAM,SAAS,GAAG,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAsB,EACtB,gBAAwB,EACxB,KAAc;IAEd,MAAM,OAAO,GAAG,KAAK,YAAY,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,OAAO;QACL,KAAK;QACL,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,KAAK,KAAK,uDAAuD,gBAAgB,GAAG;QAC7F,gBAAgB;QAChB,SAAS,EAAE,KAAK,IAAI,eAAe;QACnC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;KAChC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/core/warnings/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,gGAAgG;AAChG,kGAAkG;AAClG,MAAM,SAAS,GAAG,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,cAAc,GAAiC,IAAI,GAAG,CAAC;IAC3D,CAAC,cAAc,EAAE,iCAAiC,CAAC;IACnD,CAAC,iBAAiB,EAAE,gDAAgD,CAAC;CACtE,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAsB,EACtB,gBAAwB,EACxB,KAAc;IAEd,MAAM,OAAO,GAAG,KAAK,YAAY,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAC5D,OAAO;QACL,KAAK;QACL,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,SAAS;QACnB,OAAO,EACL,OAAO,KAAK,SAAS;YACnB,CAAC,CAAC,KAAK,KAAK,uDAAuD,gBAAgB,GAAG;YACtF,CAAC,CAAC,KAAK,KAAK,sBAAsB,OAAO,uCAAuC,gBAAgB,GAAG;QACvG,gBAAgB;QAChB,SAAS,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe;QAC/E,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/events/emitter.d.ts

@@ -1,19 +1,35 @@
 /**
  * Small typed event emitter used by sessions and hook dispatch.
- * Implements PRD §5.4.
+ * Implements PRD §5.4 and §6.4/§7A.2 tool-keyed response provenance.
  */
 import type { Unsubscribe } from "../core/types.ts";
+export type HandlerProvenance = "event" | "tool-keyed";
+export type HandlerResponse = {
+    readonly value: unknown;
+    readonly provenance: HandlerProvenance;
+};
 type EventKey<M> = Extract<keyof M, string>;
 type HandlerFor<M, E extends EventKey<M>> = (event: M[E]) => unknown;
 export declare class TypedEmitter<M extends Record<string, unknown>> {
     private readonly handlers;
+    private readonly observerErrors;
+    private observerError;
+    private retainObserverError;
+    private rejectionError;
     constructor();
     on<E extends EventKey<M>>(event: E, handler: HandlerFor<M, E>): Unsubscribe;
-    listen<E extends EventKey<M>>(event: E, handler: HandlerFor<M, E>): void;
+    listen<E extends EventKey<M>>(event: E, handler: HandlerFor<M, E>, provenance?: HandlerProvenance): void;
     off<E extends EventKey<M>>(event: E, handler: HandlerFor<M, E>): void;
     emit<E extends EventKey<M>>(event: E, payload: M[E]): void;
+    /** Capture synchronous throws and late Promise failures in this notification scope.
+     * Pending Promises retain bounded diagnostic sinks after nested scopes unwind. */
+    observeErrors<T>(onError: (error: unknown) => void, operation: () => T, retainOnOverflow?: boolean): T;
+    /** Contain returned native Promise rejections while preserving synchronous throws. */
+    observeRejections<T>(onError: (error: unknown) => void, operation: () => T): T;
     hasListeners<E extends EventKey<M>>(event: E): boolean;
     request<E extends EventKey<M>>(event: E, payload: M[E]): Promise<unknown>;
+    /** Preserve the first responding registration's origin across async hook dispatch. */
+    requestWithProvenance<E extends EventKey<M>>(event: E, payload: M[E]): Promise<HandlerResponse | undefined>;
 }
 export {};
 //# sourceMappingURL=emitter.d.ts.map

package/dist/events/emitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/events/emitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,KAAK,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAC5C,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;AASrE,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;;IAMvD,EAAE,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW;IAO3E,MAAM,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IAaxE,GAAG,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IASrE,IAAI,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IA2B1D,YAAY,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO;IAIhD,OAAO,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAUhF"}
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/events/emitter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAIpD,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,YAAY,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC,CAAC;AAEF,KAAK,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAC5C,KAAK,UAAU,CAAC,CAAC,EAAE,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;AASrE,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwB;IACvD,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,cAAc,CAAyC;;IAM/D,EAAE,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW;IAO3E,MAAM,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACzB,UAAU,GAAE,iBAA2B,GACtC,IAAI;IAaP,GAAG,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI;IASrE,IAAI,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAkC1D;sFACkF;IAClF,aAAa,CAAC,CAAC,EACb,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EACjC,SAAS,EAAE,MAAM,CAAC,EAClB,gBAAgB,UAAQ,GACvB,CAAC;IAaJ,sFAAsF;IACtF,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC;IAU9E,YAAY,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO;IAIhD,OAAO,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/E,sFAAsF;IAChF,qBAAqB,CAAC,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,EAC/C,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,GACZ,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;CAYxC"}

package/dist/events/emitter.js

@@ -1,9 +1,16 @@
 /**
  * Small typed event emitter used by sessions and hook dispatch.
- * Implements PRD §5.4.
+ * Implements PRD §5.4 and §6.4/§7A.2 tool-keyed response provenance.
  */
+import { types } from "node:util";
+import { inertRecord } from "../core/inert-record.js";
+import { ObserverErrors } from "./observer-errors.js";
 export class TypedEmitter {
     handlers;
+    observerErrors = new ObserverErrors();
+    observerError;
+    retainObserverError = false;
+    rejectionError;
     constructor() {
         this.handlers = new Map();
     }
@@ -13,18 +20,18 @@ export class TypedEmitter {
             this.off(event, handler);
         };
     }
-    listen(event, handler) {
+    listen(event, handler, provenance = "event") {
         const entry = this.handlers.get(event);
         const h = handler;
         if (!entry) {
-            this.handlers.set(event, { list: [h], live: new Set([h]) });
+            this.handlers.set(event, { list: [{ handler: h, provenance }], live: new Set([h]) });
             return;
         }
         if (entry.live.has(h))
             return;
         entry.live.add(h);
         // Copy-on-write: a fresh array so any in-flight `emit` snapshot is unaffected.
-        entry.list = [...entry.list, h];
+        entry.list = [...entry.list, { handler: h, provenance }];
     }
     off(event, handler) {
         const entry = this.handlers.get(event);
@@ -33,7 +40,7 @@ export class TypedEmitter {
             return;
         // Copy-on-write removal keeps a concurrent `emit` snapshot stable; `live`
         // (already updated) makes the unsubscribe visible to that emission at once.
-        entry.list = entry.list.filter((existing) => existing !== h);
+        entry.list = entry.list.filter((existing) => existing.handler !== h);
     }
     emit(event, payload) {
         const entry = this.handlers.get(event);
@@ -43,17 +50,21 @@ export class TypedEmitter {
         // listener must not abort iteration and wedge an internal lifecycle
         // subscriber (e.g. interrupt/compact settling on a status transition, or
         // the transcript watcher's flush). The first error is rethrown after the
-        // full fan-out so an enclosing error boundary can still observe it. The
+        // full fan-out, or captured by the active notification scope. The
         // `list` snapshot is immutable, so a listener added mid-emit does not fire
         // this round; `live` is consulted so one a prior handler removed is skipped.
         const snapshot = entry.list;
+        const onError = this.observerError;
+        const onRejection = onError ?? this.rejectionError;
         let firstError;
         let failed = false;
-        for (const handler of snapshot) {
+        for (const { handler } of snapshot) {
             if (!entry.live.has(handler))
                 continue;
             try {
-                handler(payload);
+                const returned = handler(payload);
+                if (onRejection && types.isPromise(returned))
+                    this.observerErrors.observe(returned, onRejection, this.retainObserverError);
             }
             catch (error) {
                 if (!failed) {
@@ -62,22 +73,58 @@ export class TypedEmitter {
                 }
             }
         }
-        if (failed)
-            throw firstError;
+        if (failed) {
+            if (onError)
+                onError(firstError);
+            else
+                throw firstError;
+        }
+    }
+    /** Capture synchronous throws and late Promise failures in this notification scope.
+     * Pending Promises retain bounded diagnostic sinks after nested scopes unwind. */
+    observeErrors(onError, operation, retainOnOverflow = false) {
+        const previous = this.observerError;
+        const priorRetention = this.retainObserverError;
+        this.observerError = onError;
+        this.retainObserverError = retainOnOverflow;
+        try {
+            return operation();
+        }
+        finally {
+            this.observerError = previous;
+            this.retainObserverError = priorRetention;
+        }
+    }
+    /** Contain returned native Promise rejections while preserving synchronous throws. */
+    observeRejections(onError, operation) {
+        const previous = this.rejectionError;
+        this.rejectionError = onError;
+        try {
+            return operation();
+        }
+        finally {
+            this.rejectionError = previous;
+        }
     }
     hasListeners(event) {
         return (this.handlers.get(event)?.live.size ?? 0) > 0;
     }
     async request(event, payload) {
+        return (await this.requestWithProvenance(event, payload))?.value;
+    }
+    /** Preserve the first responding registration's origin across async hook dispatch. */
+    async requestWithProvenance(event, payload) {
         const entry = this.handlers.get(event);
         if (!entry)
             return undefined;
-        for (const handler of entry.list) {
+        for (const { handler, provenance } of entry.list) {
             if (!entry.live.has(handler))
                 continue;
-            const result = await handler(payload);
-            if (result !== undefined)
-                return result;
+            const returned = handler(payload);
+            // Direct data must reach validation without Promise thenable assimilation.
+            const value = types.isPromise(returned) ? await returned : returned;
+            if (value !== undefined)
+                return inertRecord({ value, provenance });
         }
         return undefined;
     }

package/dist/events/emitter.js.map

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

package/dist/events/observer-errors.d.ts

@@ -0,0 +1,9 @@
+type Sink = (error: unknown) => void;
+export declare class ObserverErrors {
+    private readonly promises;
+    private readonly registrations;
+    /** The caller keeps reused session sinks live; overflow records retain only weak references. */
+    observe(promise: Promise<unknown>, sink: Sink, retainOnOverflow: boolean): void;
+}
+export {};
+//# sourceMappingURL=observer-errors.d.ts.map

package/dist/events/observer-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-errors.d.ts","sourceRoot":"","sources":["../../src/events/observer-errors.ts"],"names":[],"mappings":"AAGA,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AA6CrC,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IAEzD,gGAAgG;IAChG,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,GAAG,IAAI;CA+BhF"}

package/dist/events/observer-errors.js

@@ -0,0 +1,68 @@
+/** Bounds pending notification diagnostics while consuming late rejections (C-HOOK-22). */
+import { AsyncLocalStorage } from "node:async_hooks";
+const MAX_PENDING = 1_024;
+const promiseThen = Promise.prototype.then;
+// These callbacks capture only the Promise's record. Eviction empties its entry
+// set, so a retained never-settling Promise cannot retain an invocation or emitter.
+function attach(promise, pending) {
+    const settle = (rejected, error) => {
+        pending.settled = true;
+        const entries = [...pending.entries];
+        pending.entries.clear();
+        for (const entry of entries)
+            entry.release();
+        const overflowSink = pending.overflowSink?.deref();
+        pending.overflowSink = undefined;
+        if (rejected) {
+            for (const sink of [
+                ...(overflowSink ? [overflowSink] : []),
+                ...entries.map((entry) => entry.sink),
+            ]) {
+                try {
+                    sink(error);
+                }
+                catch {
+                    /* A diagnostic cannot create another rejection. */
+                }
+            }
+        }
+    };
+    void promiseThen.call(promise, () => settle(false), (error) => settle(true, error));
+}
+export class ObserverErrors {
+    promises = new WeakMap();
+    registrations = new Set();
+    /** The caller keeps reused session sinks live; overflow records retain only weak references. */
+    observe(promise, sink, retainOnOverflow) {
+        let pending = this.promises.get(promise);
+        if (!pending || pending.settled) {
+            pending = { settled: false, entries: new Set(), overflowSink: undefined };
+            // Native attachment may throw while evaluating caller constructor/species.
+            // Cache only after success so a later notification can retry.
+            attach(promise, pending);
+            this.promises.set(promise, pending);
+        }
+        const registrations = this.registrations;
+        const entry = {
+            pending,
+            // A shared Promise reaction inherits only the first registration's context.
+            sink: AsyncLocalStorage.bind(sink),
+            overflowSink: retainOnOverflow ? new WeakRef(sink) : undefined,
+            release: () => {
+                registrations.delete(entry);
+            },
+        };
+        pending.entries.add(entry);
+        registrations.add(entry);
+        if (registrations.size > MAX_PENDING) {
+            // Size exceeds a positive cap, so the oldest entry necessarily exists.
+            const oldest = registrations.values().next().value;
+            // The live session owns stable sinks; evicted promises must not retain that session.
+            if (oldest.overflowSink && !oldest.pending.overflowSink)
+                oldest.pending.overflowSink = oldest.overflowSink;
+            oldest.pending.entries.delete(oldest);
+            registrations.delete(oldest);
+        }
+    }
+}
+//# sourceMappingURL=observer-errors.js.map

package/dist/events/observer-errors.js.map

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

package/dist/index.d.ts

@@ -29,6 +29,7 @@ export { parseLoopCommand } from "./core/loops/parser.ts";
 export type { ElwoodLoopEvent, ElwoodLoopEventSnapshot, ElwoodLoopRequest, ElwoodLoopSnapshot, ElwoodLoopState, } from "./core/loops/types.ts";
 export type { ListModelsOptions } from "./core/models/list.ts";
 export type { AgentModelOption } from "./core/models/rows.ts";
+export type { ElwoodQuestion, ElwoodQuestionAnswer, ElwoodQuestionAnswerOptions, ElwoodQuestionEvent, ElwoodQuestionOption, ElwoodQuestionRequest, QuestionCloseReason, } from "./core/questions/types.ts";
 export type { ClaudeReasoningEffort, CodexReasoningEffort } from "./core/reasoning-effort.ts";
 export type { TurnEvent } from "./core/simple/events.ts";
 export type { TurnOptions } from "./core/simple/session.ts";

package/dist/index.d.ts.map

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

package/dist/pty/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/pty/node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,UAAU,EAA+B,MAAM,YAAY,CAAC;AAI1E,eAAO,MAAM,cAAc,EAAE,UAmC5B,CAAC;AAMF,wBAAgB,sBAAsB,IAAI,MAAM,CAO/C;AAED;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,SAA2B,GAAG,IAAI,CAaxF"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/pty/node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,UAAU,EAA+B,MAAM,YAAY,CAAC;AAI1E,eAAO,MAAM,cAAc,EAAE,UAuC5B,CAAC;AAMF,wBAAgB,sBAAsB,IAAI,MAAM,CAO/C;AAED;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAAC,IAAI,SAA2B,GAAG,IAAI,CAaxF"}

package/dist/pty/node.js

@@ -18,6 +18,10 @@ export const nodePtyFactory = (options) => {
     });
     return {
         pid: pty.pid,
+        flowControl: {
+            pause: () => pty.pause(),
+            resume: () => pty.resume(),
+        },
         onData(handler) {
             const disposable = pty.onData(handler);
             return () => disposable.dispose();

package/dist/pty/node.js.map

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

package/dist/pty/types.d.ts

@@ -16,6 +16,11 @@ export type PtySpawnOptions = {
 };
 export interface PtyProcess {
     readonly pid: number;
+    /** Optional for test adapters; real PTYs pause reads while the renderer catches up. */
+    readonly flowControl?: {
+        readonly pause: () => void;
+        readonly resume: () => void;
+    };
     onData(handler: (data: string) => void): () => void;
     onExit(handler: (exit: PtyExit) => void): () => void;
     write(data: string | Uint8Array): void;

package/dist/pty/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pty/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACpD,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACvC,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,UAAU,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pty/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;QAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;KAC7B,CAAC;IACF,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACpD,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACvC,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,UAAU,CAAC"}

package/dist/runtime/probe-cleanup.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Process-group liveness and bounded termination for aborted probes.
+ * Implements PRD §9.2 / C-PERF-03 and C-PERF-04: an aborted probe's cleanup is bounded,
+ * a reissued group id is never signaled, and a surviving updater group retains exclusion.
+ */
+import type { ChildProcess } from "node:child_process";
+import { type ReapErrorCode } from "../core/warnings/reasons.ts";
+/**
+ * Unconfirmed cleanup names both the reason and the group still outstanding; confirmed
+ * cleanup names neither. Both fields are optional because `CommandResult` intersects this
+ * into an error shape that exists for every failed probe, not only aborted ones — the two
+ * are nevertheless always written together, by `abortProbe` alone.
+ */
+export type ProbeCleanup = {
+    readonly cleanupErrorCode?: ReapErrorCode | "ETIMEDOUT";
+    readonly cleanupProcessGroupId?: number;
+};
+/**
+ * Whether a process group has fully exited. Signal 0 delivers nothing — it only asks the
+ * kernel whether the group could be signaled — so observing a group can never disturb it.
+ * Only `ESRCH` proves absence: any other error (notably `EPERM`, a group this user may not
+ * signal) means something is still there, so the group counts as live and the lease it
+ * holds is kept. Guessing "gone" here would let a second updater run against a live one.
+ */
+export declare function processGroupGone(processGroupId: number): boolean;
+/**
+ * Observes an aborted updater's groups for a short window without signaling them, and
+ * returns those still live. A group that exits on its own in that window never retains the
+ * lease, so an update whose descendants are merely slow to finish costs one second rather
+ * than a lease the next host has to wait out.
+ */
+export declare function waitForProbeGroups(processGroupIds: readonly number[]): Promise<readonly number[]>;
+export declare function abortProbe(child: ChildProcess): Promise<ProbeCleanup>;
+//# sourceMappingURL=probe-cleanup.d.ts.map

package/dist/runtime/probe-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-cleanup.d.ts","sourceRoot":"","sources":["../../src/runtime/probe-cleanup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAErC;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,GAAG,WAAW,CAAC;IACxD,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CACzC,CAAC;AASF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAOhE;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,eAAe,EAAE,SAAS,MAAM,EAAE,GACjC,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAW5B;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAqC3E"}