@code-yeongyu/senpi 2026.9.11 → 2026.9.12-3

package/node_modules/@earendil-works/pi-agent-core/dist/harness/events.js

@@ -1,67 +1,245 @@
+/** Passive harness event bus with isolated handler failures. */
 export class HarnessEventBus {
     constructor() {
         this.listeners = new Map();
         this.watchListeners = new Set();
+        this.deliveryTail = Promise.resolve();
     }
-    /**
-     * Register a listener for future events of one type and return its unsubscribe function.
-     * Earlier events are not replayed, and no snapshot or event buffer is provided.
-     */
     on(type, listener) {
-        // Reuse this event type's listener set, or create its first set.
-        const listeners = this.listeners.get(type) ?? new Set();
-        this.listeners.set(type, listeners);
-        // Wrap this event-specific callback so it can be stored as a general HarnessEvent listener.
-        // Keep the wrapper reference so unsubscribe can remove that exact function from the set.
-        const receive = (event) => {
-            if (event.type === type)
-                return listener(event);
-        };
-        listeners.add(receive);
-        return () => {
-            listeners.delete(receive);
-            if (listeners.size === 0)
-                this.listeners.delete(type);
-        };
+        if (this.closedError !== undefined)
+            throw this.closedError;
+        const wrapped = (event, context) => listener(event, context);
+        let listeners = this.listeners.get(type);
+        if (listeners === undefined) {
+            listeners = new Set();
+            this.listeners.set(type, listeners);
+        }
+        listeners.add(wrapped);
+        return () => listeners?.delete(wrapped);
+    }
+    emit(event, context) {
+        return this.emitBatch([event], context);
+    }
+    /** Bind current recipients and append one contiguous batch to the global delivery tail. */
+    emitBatch(events, context) {
+        if (this.closedError !== undefined || events.length === 0)
+            return Promise.resolve();
+        const bound = events.map((event) => {
+            const payload = structuredClone(event);
+            return { payload, recipients: this.snapshotRecipients(payload) };
+        });
+        const delivery = this.deliveryTail.then(async () => {
+            for (const { payload, recipients } of bound)
+                await this.deliver(payload, recipients, true, context);
+        });
+        this.deliveryTail = delivery.catch(() => { });
+        return delivery;
+    }
+    watch(snapshot, filter, _context, resnapshot) {
+        if (this.closedError !== undefined)
+            throw this.closedError;
+        return this.installWatcher(snapshot, filter, resnapshot);
     }
-    /** Publish an event to current event subscriptions and watch subscriptions. */
-    emit(event) {
-        // Deliver only to direct listeners registered for this event type.
-        // Async results are not awaited because emit() is synchronous.
-        for (const listener of this.listeners.get(event.type) ?? [])
-            void listener(event);
-        // Deliver every event to each watcher; watch() handles buffering until start().
-        for (const listener of this.watchListeners)
-            listener(event);
-    }
-    watch(captureSnapshot) {
-        let listener;
-        let buffered = [];
-        const receive = (event) => {
-            if (listener)
-                void listener(event);
-            else
-                buffered.push(event);
+    async watchFromSnapshot(capture, filter, context) {
+        if (this.closedError !== undefined)
+            throw this.closedError;
+        const watcher = this.installWatcher(undefined, filter, async (captureContext, markBoundary) => {
+            const snapshot = await capture(captureContext);
+            markBoundary();
+            return snapshot;
+        });
+        try {
+            watcher.setSnapshot(await capture(context));
+            return watcher;
+        }
+        catch (error) {
+            watcher.unsubscribe();
+            throw error;
+        }
+    }
+    close(error) {
+        this.closedError ??= error;
+        void this.deliveryTail.finally(() => {
+            this.listeners.clear();
+            this.watchListeners.clear();
+        });
+    }
+    installWatcher(snapshot, filter, resnapshot) {
+        let watcher;
+        const capture = resnapshot === undefined
+            ? undefined
+            : async (context) => {
+                let marked = false;
+                const next = await resnapshot(context, () => {
+                    if (marked)
+                        throw new Error("Resnapshot boundary was already marked");
+                    marked = true;
+                    this.enqueueBarrier(() => watcher.markResnapshotBoundary());
+                });
+                if (!marked)
+                    throw new Error("Resnapshot capture did not mark its boundary");
+                return next;
+            };
+        watcher = new BufferedEventWatcher(snapshot, capture, async (error, event, context) => {
+            if (event.type === "handler_error")
+                return;
+            const normalized = error instanceof Error ? error : new Error(String(error));
+            const lane = "lane" in event && typeof event.lane === "string" ? event.lane : undefined;
+            await this.emit({
+                type: "handler_error",
+                kind: "event",
+                event: event.type,
+                error: normalized.message,
+                ...(normalized.stack === undefined ? {} : { stack: normalized.stack }),
+                ...(lane === undefined ? {} : { lane }),
+            }, context);
+        });
+        const watchListener = (event, context) => {
+            if (filter(event))
+                watcher.push(event, context);
         };
-        this.watchListeners.add(receive);
-        const snapshot = captureSnapshot();
-        return {
-            snapshot,
-            start: (nextListener) => {
-                // Stay in buffering mode while flushing so reentrant emissions preserve order.
-                while (buffered.length > 0) {
-                    const pending = buffered;
-                    buffered = [];
-                    for (const event of pending)
-                        void nextListener(event);
-                }
-                listener = nextListener;
-            },
-            unsubscribe: () => {
-                this.watchListeners.delete(receive);
-                buffered = [];
-            },
+        this.watchListeners.add(watchListener);
+        watcher.setUnsubscribe(() => this.watchListeners.delete(watchListener));
+        return watcher;
+    }
+    enqueueBarrier(barrier) {
+        const delivery = this.deliveryTail.then(barrier);
+        this.deliveryTail = delivery.catch(() => { });
+    }
+    snapshotRecipients(event) {
+        return [...(this.listeners.get(event.type) ?? []), ...this.watchListeners];
+    }
+    async deliver(event, recipients, reportErrors, context) {
+        for (const listener of recipients) {
+            try {
+                await listener(structuredClone(event), context);
+            }
+            catch (error) {
+                if (!reportErrors || event.type === "handler_error")
+                    continue;
+                const normalized = error instanceof Error ? error : new Error(String(error));
+                const lane = "lane" in event && typeof event.lane === "string" ? event.lane : undefined;
+                const handlerError = {
+                    type: "handler_error",
+                    kind: "event",
+                    event: event.type,
+                    error: normalized.message,
+                    ...(normalized.stack === undefined ? {} : { stack: normalized.stack }),
+                    ...(lane === undefined ? {} : { lane }),
+                };
+                await this.deliver(handlerError, this.snapshotRecipients(handlerError), false, context);
+            }
+        }
+    }
+}
+class BufferedEventWatcher {
+    constructor(snapshot, resnapshot, onError) {
+        this.buffer = [];
+        this.deliveryTail = Promise.resolve();
+        this.epoch = 0;
+        this.state = "buffering";
+        this.snapshot = snapshot;
+        this.resnapshotCallback = resnapshot;
+        this.onError = onError;
+    }
+    setSnapshot(snapshot) {
+        this.snapshot = snapshot;
+    }
+    start(listener) {
+        if (this.state !== "buffering")
+            throw new Error("WatchHandle.start() may be called only once");
+        this.state = "started";
+        this.listener = listener;
+        const buffered = this.buffer;
+        this.buffer = [];
+        for (const bufferedEvent of buffered) {
+            this.enqueue(bufferedEvent.event, bufferedEvent.context, bufferedEvent.epoch);
+        }
+    }
+    async resnapshot(context) {
+        if (this.state === "unsubscribed")
+            throw new Error("WatchHandle is unsubscribed");
+        if (this.resnapshotCallback === undefined)
+            throw new Error("WatchHandle does not support resnapshot");
+        if (this.resnapshotState !== undefined)
+            throw new Error("WatchHandle resnapshot is already in progress");
+        let resolveReached;
+        const reached = new Promise((resolve) => {
+            resolveReached = resolve;
+        });
+        const resnapshotState = {
+            phase: "dropping",
+            held: [],
+            reached,
+            resolveReached,
         };
+        this.epoch++;
+        this.resnapshotState = resnapshotState;
+        try {
+            const snapshot = await this.resnapshotCallback(context);
+            await reached;
+            this.snapshot = snapshot;
+            this.resnapshotState = undefined;
+            for (const held of resnapshotState.held)
+                this.push(held.event, held.context);
+            return snapshot;
+        }
+        catch (error) {
+            this.resnapshotState = undefined;
+            for (const held of resnapshotState.held)
+                this.push(held.event, held.context);
+            throw error;
+        }
+    }
+    markResnapshotBoundary() {
+        const resnapshot = this.resnapshotState;
+        if (resnapshot === undefined || resnapshot.phase !== "dropping")
+            return;
+        resnapshot.phase = "holding";
+        resnapshot.resolveReached();
+    }
+    unsubscribe() {
+        if (this.state === "unsubscribed")
+            return;
+        this.state = "unsubscribed";
+        this.buffer = [];
+        this.listener = undefined;
+        this.unsubscribeCallback?.();
+        this.unsubscribeCallback = undefined;
+    }
+    push(event, context) {
+        if (this.state === "unsubscribed")
+            return;
+        if (this.resnapshotState?.phase === "dropping")
+            return;
+        if (this.resnapshotState?.phase === "holding") {
+            this.resnapshotState.held.push({ event, context });
+            return;
+        }
+        if (this.state === "buffering") {
+            this.buffer.push({ event, context, epoch: this.epoch });
+            return;
+        }
+        this.enqueue(event, context, this.epoch);
+    }
+    setUnsubscribe(callback) {
+        this.unsubscribeCallback = callback;
+    }
+    enqueue(event, context, epoch) {
+        const listener = this.listener;
+        if (listener === undefined)
+            return;
+        this.deliveryTail = this.deliveryTail
+            .then(async () => {
+            if (this.state === "started" && epoch === this.epoch)
+                await listener(event, context);
+        })
+            .catch(async (error) => {
+            try {
+                await this.onError(error, event, context);
+            }
+            catch { }
+        });
     }
 }
 //# sourceMappingURL=events.js.map

package/node_modules/@earendil-works/pi-agent-core/dist/harness/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/harness/events.ts"],"names":[],"mappings":"AAoCA,MAAM,OAAO,eAAe;IAA5B;QACkB,cAAS,GAAG,IAAI,GAAG,EAA+C,CAAC;QACnE,mBAAc,GAAG,IAAI,GAAG,EAAiC,CAAC;IA+D5E,CAAC;IA7DA;;;OAGG;IACH,EAAE,CACD,IAAW,EACX,QAAyD;QAEzD,iEAAiE;QACjE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAwB,CAAC;QAC9E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAEpC,4FAA4F;QAC5F,yFAAyF;QACzF,MAAM,OAAO,GAAyB,CAAC,KAAK,EAAE,EAAE;YAC/C,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO,QAAQ,CAAC,KAAkC,CAAC,CAAC;QAC9E,CAAC,CAAC;QACF,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,GAAG,EAAE;YACX,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC1B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvD,CAAC,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,IAAI,CAAC,KAAmB;QACvB,mEAAmE;QACnE,+DAA+D;QAC/D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC;QAElF,gFAAgF;QAChF,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAY,eAAgC;QAChD,IAAI,QAA0C,CAAC;QAC/C,IAAI,QAAQ,GAAmB,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,CAAC,KAAmB,EAAQ,EAAE;YAC7C,IAAI,QAAQ;gBAAE,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC;;gBAC9B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC;QACF,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;QAEnC,OAAO;YACN,QAAQ;YACR,KAAK,EAAE,CAAC,YAAY,EAAE,EAAE;gBACvB,+EAA+E;gBAC/E,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC;oBACzB,QAAQ,GAAG,EAAE,CAAC;oBACd,KAAK,MAAM,KAAK,IAAI,OAAO;wBAAE,KAAK,YAAY,CAAC,KAAK,CAAC,CAAC;gBACvD,CAAC;gBACD,QAAQ,GAAG,YAAY,CAAC;YACzB,CAAC;YACD,WAAW,EAAE,GAAG,EAAE;gBACjB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACpC,QAAQ,GAAG,EAAE,CAAC;YACf,CAAC;SACD,CAAC;IACH,CAAC;CACD","sourcesContent":["export interface RunStartEvent {\n\ttype: \"run_start\";\n\tlane: string;\n\trunId: string;\n}\n\nexport interface RunEndEvent {\n\ttype: \"run_end\";\n\tlane: string;\n\trunId: string;\n\toutcome: \"completed\" | \"aborted\" | \"failed\";\n\tleafId: string;\n}\n\nexport type HarnessEvent = RunStartEvent | RunEndEvent;\nexport type HarnessEventType = HarnessEvent[\"type\"];\nexport type HarnessEventOfType<TType extends HarnessEventType> = Extract<HarnessEvent, { type: TType }>;\nexport type HarnessEventListener<TEvent extends HarnessEvent = HarnessEvent> = (event: TEvent) => void | Promise<void>;\n\nexport interface Events {\n\t/**\n\t * Register a passive listener for future events and return its unsubscribe function.\n\t * Earlier events are not replayed and no current-state snapshot is provided; use a lane or session watch for both.\n\t */\n\ton<TType extends HarnessEventType>(\n\t\ttype: TType,\n\t\tlistener: HarnessEventListener<HarnessEventOfType<TType>>,\n\t): () => void;\n}\n\nexport interface WatchHandle<TSnapshot> {\n\tsnapshot: TSnapshot;\n\tstart(listener: HarnessEventListener): void;\n\tunsubscribe(): void;\n}\n\nexport class HarnessEventBus implements Events {\n\tprivate readonly listeners = new Map<HarnessEventType, Set<HarnessEventListener>>();\n\tprivate readonly watchListeners = new Set<(event: HarnessEvent) => void>();\n\n\t/**\n\t * Register a listener for future events of one type and return its unsubscribe function.\n\t * Earlier events are not replayed, and no snapshot or event buffer is provided.\n\t */\n\ton<TType extends HarnessEventType>(\n\t\ttype: TType,\n\t\tlistener: HarnessEventListener<HarnessEventOfType<TType>>,\n\t): () => void {\n\t\t// Reuse this event type's listener set, or create its first set.\n\t\tconst listeners = this.listeners.get(type) ?? new Set<HarnessEventListener>();\n\t\tthis.listeners.set(type, listeners);\n\n\t\t// Wrap this event-specific callback so it can be stored as a general HarnessEvent listener.\n\t\t// Keep the wrapper reference so unsubscribe can remove that exact function from the set.\n\t\tconst receive: HarnessEventListener = (event) => {\n\t\t\tif (event.type === type) return listener(event as HarnessEventOfType<TType>);\n\t\t};\n\t\tlisteners.add(receive);\n\t\treturn () => {\n\t\t\tlisteners.delete(receive);\n\t\t\tif (listeners.size === 0) this.listeners.delete(type);\n\t\t};\n\t}\n\n\t/** Publish an event to current event subscriptions and watch subscriptions. */\n\temit(event: HarnessEvent): void {\n\t\t// Deliver only to direct listeners registered for this event type.\n\t\t// Async results are not awaited because emit() is synchronous.\n\t\tfor (const listener of this.listeners.get(event.type) ?? []) void listener(event);\n\n\t\t// Deliver every event to each watcher; watch() handles buffering until start().\n\t\tfor (const listener of this.watchListeners) listener(event);\n\t}\n\n\twatch<TSnapshot>(captureSnapshot: () => TSnapshot): WatchHandle<TSnapshot> {\n\t\tlet listener: HarnessEventListener | undefined;\n\t\tlet buffered: HarnessEvent[] = [];\n\t\tconst receive = (event: HarnessEvent): void => {\n\t\t\tif (listener) void listener(event);\n\t\t\telse buffered.push(event);\n\t\t};\n\t\tthis.watchListeners.add(receive);\n\t\tconst snapshot = captureSnapshot();\n\n\t\treturn {\n\t\t\tsnapshot,\n\t\t\tstart: (nextListener) => {\n\t\t\t\t// Stay in buffering mode while flushing so reentrant emissions preserve order.\n\t\t\t\twhile (buffered.length > 0) {\n\t\t\t\t\tconst pending = buffered;\n\t\t\t\t\tbuffered = [];\n\t\t\t\t\tfor (const event of pending) void nextListener(event);\n\t\t\t\t}\n\t\t\t\tlistener = nextListener;\n\t\t\t},\n\t\t\tunsubscribe: () => {\n\t\t\t\tthis.watchListeners.delete(receive);\n\t\t\t\tbuffered = [];\n\t\t\t},\n\t\t};\n\t}\n}\n"]}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/harness/events.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EventListener, Events, HarnessEvent, HarnessEventType, WatchHandle } from \"./agent-harness.ts\";\nimport type { Context } from \"./context.ts\";\n\ntype UntypedEventListener = (event: HarnessEvent, context: Context) => void | Promise<void>;\ntype ResnapshotCapture<T> = (context: Context, markBoundary: () => void) => Promise<T>;\n\n/** Passive harness event bus with isolated handler failures. */\nexport class HarnessEventBus implements Events {\n\tprivate readonly listeners = new Map<HarnessEventType, Set<UntypedEventListener>>();\n\tprivate readonly watchListeners = new Set<UntypedEventListener>();\n\tprivate deliveryTail: Promise<void> = Promise.resolve();\n\tprivate closedError: Error | undefined;\n\n\ton<TType extends HarnessEventType>(\n\t\ttype: TType,\n\t\tlistener: EventListener<Extract<HarnessEvent, { type: TType }>>,\n\t): () => void {\n\t\tif (this.closedError !== undefined) throw this.closedError;\n\t\tconst wrapped: UntypedEventListener = (event, context) =>\n\t\t\tlistener(event as Extract<HarnessEvent, { type: TType }>, context);\n\t\tlet listeners = this.listeners.get(type);\n\t\tif (listeners === undefined) {\n\t\t\tlisteners = new Set();\n\t\t\tthis.listeners.set(type, listeners);\n\t\t}\n\t\tlisteners.add(wrapped);\n\t\treturn () => listeners?.delete(wrapped);\n\t}\n\n\temit(event: HarnessEvent, context: Context): Promise<void> {\n\t\treturn this.emitBatch([event], context);\n\t}\n\n\t/** Bind current recipients and append one contiguous batch to the global delivery tail. */\n\temitBatch(events: readonly HarnessEvent[], context: Context): Promise<void> {\n\t\tif (this.closedError !== undefined || events.length === 0) return Promise.resolve();\n\t\tconst bound = events.map((event) => {\n\t\t\tconst payload = structuredClone(event);\n\t\t\treturn { payload, recipients: this.snapshotRecipients(payload) };\n\t\t});\n\t\tconst delivery = this.deliveryTail.then(async () => {\n\t\t\tfor (const { payload, recipients } of bound) await this.deliver(payload, recipients, true, context);\n\t\t});\n\t\tthis.deliveryTail = delivery.catch(() => {});\n\t\treturn delivery;\n\t}\n\n\twatch<T>(\n\t\tsnapshot: T,\n\t\tfilter: (event: HarnessEvent) => boolean,\n\t\t_context: Context,\n\t\tresnapshot?: ResnapshotCapture<T>,\n\t): WatchHandle<T> {\n\t\tif (this.closedError !== undefined) throw this.closedError;\n\t\treturn this.installWatcher(snapshot, filter, resnapshot);\n\t}\n\n\tasync watchFromSnapshot<T>(\n\t\tcapture: (context: Context) => Promise<T>,\n\t\tfilter: (event: HarnessEvent) => boolean,\n\t\tcontext: Context,\n\t): Promise<WatchHandle<T>> {\n\t\tif (this.closedError !== undefined) throw this.closedError;\n\t\tconst watcher = this.installWatcher<T>(undefined, filter, async (captureContext, markBoundary) => {\n\t\t\tconst snapshot = await capture(captureContext);\n\t\t\tmarkBoundary();\n\t\t\treturn snapshot;\n\t\t});\n\t\ttry {\n\t\t\twatcher.setSnapshot(await capture(context));\n\t\t\treturn watcher;\n\t\t} catch (error) {\n\t\t\twatcher.unsubscribe();\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tclose(error: Error): void {\n\t\tthis.closedError ??= error;\n\t\tvoid this.deliveryTail.finally(() => {\n\t\t\tthis.listeners.clear();\n\t\t\tthis.watchListeners.clear();\n\t\t});\n\t}\n\n\tprivate installWatcher<T>(\n\t\tsnapshot: T | undefined,\n\t\tfilter: (event: HarnessEvent) => boolean,\n\t\tresnapshot: ResnapshotCapture<T> | undefined,\n\t): BufferedEventWatcher<T> {\n\t\tlet watcher!: BufferedEventWatcher<T>;\n\t\tconst capture =\n\t\t\tresnapshot === undefined\n\t\t\t\t? undefined\n\t\t\t\t: async (context: Context) => {\n\t\t\t\t\t\tlet marked = false;\n\t\t\t\t\t\tconst next = await resnapshot(context, () => {\n\t\t\t\t\t\t\tif (marked) throw new Error(\"Resnapshot boundary was already marked\");\n\t\t\t\t\t\t\tmarked = true;\n\t\t\t\t\t\t\tthis.enqueueBarrier(() => watcher.markResnapshotBoundary());\n\t\t\t\t\t\t});\n\t\t\t\t\t\tif (!marked) throw new Error(\"Resnapshot capture did not mark its boundary\");\n\t\t\t\t\t\treturn next;\n\t\t\t\t\t};\n\t\twatcher = new BufferedEventWatcher(snapshot, capture, async (error, event, context) => {\n\t\t\tif (event.type === \"handler_error\") return;\n\t\t\tconst normalized = error instanceof Error ? error : new Error(String(error));\n\t\t\tconst lane = \"lane\" in event && typeof event.lane === \"string\" ? event.lane : undefined;\n\t\t\tawait this.emit(\n\t\t\t\t{\n\t\t\t\t\ttype: \"handler_error\",\n\t\t\t\t\tkind: \"event\",\n\t\t\t\t\tevent: event.type,\n\t\t\t\t\terror: normalized.message,\n\t\t\t\t\t...(normalized.stack === undefined ? {} : { stack: normalized.stack }),\n\t\t\t\t\t...(lane === undefined ? {} : { lane }),\n\t\t\t\t},\n\t\t\t\tcontext,\n\t\t\t);\n\t\t});\n\t\tconst watchListener: UntypedEventListener = (event, context) => {\n\t\t\tif (filter(event)) watcher.push(event, context);\n\t\t};\n\t\tthis.watchListeners.add(watchListener);\n\t\twatcher.setUnsubscribe(() => this.watchListeners.delete(watchListener));\n\t\treturn watcher;\n\t}\n\n\tprivate enqueueBarrier(barrier: () => void): void {\n\t\tconst delivery = this.deliveryTail.then(barrier);\n\t\tthis.deliveryTail = delivery.catch(() => {});\n\t}\n\n\tprivate snapshotRecipients(event: HarnessEvent): UntypedEventListener[] {\n\t\treturn [...(this.listeners.get(event.type) ?? []), ...this.watchListeners];\n\t}\n\n\tprivate async deliver(\n\t\tevent: HarnessEvent,\n\t\trecipients: readonly UntypedEventListener[],\n\t\treportErrors: boolean,\n\t\tcontext: Context,\n\t): Promise<void> {\n\t\tfor (const listener of recipients) {\n\t\t\ttry {\n\t\t\t\tawait listener(structuredClone(event), context);\n\t\t\t} catch (error) {\n\t\t\t\tif (!reportErrors || event.type === \"handler_error\") continue;\n\t\t\t\tconst normalized = error instanceof Error ? error : new Error(String(error));\n\t\t\t\tconst lane = \"lane\" in event && typeof event.lane === \"string\" ? event.lane : undefined;\n\t\t\t\tconst handlerError: HarnessEvent = {\n\t\t\t\t\ttype: \"handler_error\",\n\t\t\t\t\tkind: \"event\",\n\t\t\t\t\tevent: event.type,\n\t\t\t\t\terror: normalized.message,\n\t\t\t\t\t...(normalized.stack === undefined ? {} : { stack: normalized.stack }),\n\t\t\t\t\t...(lane === undefined ? {} : { lane }),\n\t\t\t\t};\n\t\t\t\tawait this.deliver(handlerError, this.snapshotRecipients(handlerError), false, context);\n\t\t\t}\n\t\t}\n\t}\n}\n\nclass BufferedEventWatcher<T> implements WatchHandle<T> {\n\tsnapshot: T;\n\tprivate readonly resnapshotCallback: ((context: Context) => Promise<T>) | undefined;\n\tprivate readonly onError: (error: unknown, event: HarnessEvent, context: Context) => void | Promise<void>;\n\tprivate buffer: Array<{ event: HarnessEvent; context: Context; epoch: number }> = [];\n\tprivate listener: EventListener | undefined;\n\tprivate unsubscribeCallback: (() => void) | undefined;\n\tprivate deliveryTail: Promise<void> = Promise.resolve();\n\tprivate epoch = 0;\n\tprivate resnapshotState:\n\t\t| {\n\t\t\t\tphase: \"dropping\" | \"holding\";\n\t\t\t\theld: Array<{ event: HarnessEvent; context: Context }>;\n\t\t\t\treached: Promise<void>;\n\t\t\t\tresolveReached: () => void;\n\t\t  }\n\t\t| undefined;\n\tprivate state: \"buffering\" | \"started\" | \"unsubscribed\" = \"buffering\";\n\n\tconstructor(\n\t\tsnapshot: T | undefined,\n\t\tresnapshot: ((context: Context) => Promise<T>) | undefined,\n\t\tonError: (error: unknown, event: HarnessEvent, context: Context) => void | Promise<void>,\n\t) {\n\t\tthis.snapshot = snapshot as T;\n\t\tthis.resnapshotCallback = resnapshot;\n\t\tthis.onError = onError;\n\t}\n\n\tsetSnapshot(snapshot: T): void {\n\t\tthis.snapshot = snapshot;\n\t}\n\n\tstart(listener: EventListener): void {\n\t\tif (this.state !== \"buffering\") throw new Error(\"WatchHandle.start() may be called only once\");\n\t\tthis.state = \"started\";\n\t\tthis.listener = listener;\n\t\tconst buffered = this.buffer;\n\t\tthis.buffer = [];\n\t\tfor (const bufferedEvent of buffered) {\n\t\t\tthis.enqueue(bufferedEvent.event, bufferedEvent.context, bufferedEvent.epoch);\n\t\t}\n\t}\n\n\tasync resnapshot(context: Context): Promise<T> {\n\t\tif (this.state === \"unsubscribed\") throw new Error(\"WatchHandle is unsubscribed\");\n\t\tif (this.resnapshotCallback === undefined) throw new Error(\"WatchHandle does not support resnapshot\");\n\t\tif (this.resnapshotState !== undefined) throw new Error(\"WatchHandle resnapshot is already in progress\");\n\t\tlet resolveReached!: () => void;\n\t\tconst reached = new Promise<void>((resolve) => {\n\t\t\tresolveReached = resolve;\n\t\t});\n\t\tconst resnapshotState = {\n\t\t\tphase: \"dropping\" as const,\n\t\t\theld: [] as Array<{ event: HarnessEvent; context: Context }>,\n\t\t\treached,\n\t\t\tresolveReached,\n\t\t};\n\t\tthis.epoch++;\n\t\tthis.resnapshotState = resnapshotState;\n\t\ttry {\n\t\t\tconst snapshot = await this.resnapshotCallback(context);\n\t\t\tawait reached;\n\t\t\tthis.snapshot = snapshot;\n\t\t\tthis.resnapshotState = undefined;\n\t\t\tfor (const held of resnapshotState.held) this.push(held.event, held.context);\n\t\t\treturn snapshot;\n\t\t} catch (error) {\n\t\t\tthis.resnapshotState = undefined;\n\t\t\tfor (const held of resnapshotState.held) this.push(held.event, held.context);\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tmarkResnapshotBoundary(): void {\n\t\tconst resnapshot = this.resnapshotState;\n\t\tif (resnapshot === undefined || resnapshot.phase !== \"dropping\") return;\n\t\tresnapshot.phase = \"holding\";\n\t\tresnapshot.resolveReached();\n\t}\n\n\tunsubscribe(): void {\n\t\tif (this.state === \"unsubscribed\") return;\n\t\tthis.state = \"unsubscribed\";\n\t\tthis.buffer = [];\n\t\tthis.listener = undefined;\n\t\tthis.unsubscribeCallback?.();\n\t\tthis.unsubscribeCallback = undefined;\n\t}\n\n\tpush(event: HarnessEvent, context: Context): void {\n\t\tif (this.state === \"unsubscribed\") return;\n\t\tif (this.resnapshotState?.phase === \"dropping\") return;\n\t\tif (this.resnapshotState?.phase === \"holding\") {\n\t\t\tthis.resnapshotState.held.push({ event, context });\n\t\t\treturn;\n\t\t}\n\t\tif (this.state === \"buffering\") {\n\t\t\tthis.buffer.push({ event, context, epoch: this.epoch });\n\t\t\treturn;\n\t\t}\n\t\tthis.enqueue(event, context, this.epoch);\n\t}\n\n\tsetUnsubscribe(callback: () => void): void {\n\t\tthis.unsubscribeCallback = callback;\n\t}\n\n\tprivate enqueue(event: HarnessEvent, context: Context, epoch: number): void {\n\t\tconst listener = this.listener;\n\t\tif (listener === undefined) return;\n\t\tthis.deliveryTail = this.deliveryTail\n\t\t\t.then(async () => {\n\t\t\t\tif (this.state === \"started\" && epoch === this.epoch) await listener(event, context);\n\t\t\t})\n\t\t\t.catch(async (error) => {\n\t\t\t\ttry {\n\t\t\t\t\tawait this.onError(error, event, context);\n\t\t\t\t} catch {}\n\t\t\t});\n\t}\n}\n"]}

package/node_modules/@earendil-works/pi-agent-core/dist/harness/execution/assistant.d.ts

@@ -0,0 +1,42 @@
+import type { Context as AiContext, Api, AssistantMessage, AssistantMessageEvent, AssistantMessageEventStream, Message, Model, SimpleStreamOptions, Tool } from "@earendil-works/pi-ai";
+import type { AgentMessage, ThinkingLevel } from "../../types.ts";
+import { type Context } from "../context.ts";
+import type { SettledAssistantMessage } from "../session/types.ts";
+import type { AgentHarnessStreamOptions } from "../types.ts";
+/** HTTP response metadata captured before the provider response body is consumed. */
+export interface AssistantResponseMetadata {
+    status?: number;
+    headers?: Record<string, string>;
+}
+/** Process-local lifecycle observer for one assistant stream. */
+export interface AssistantStreamObserver {
+    start(message: AssistantMessage, event: Extract<AssistantMessageEvent, {
+        type: "start";
+    }>, context: Context): void | Promise<void>;
+    update(message: AssistantMessage, event: AssistantMessageEvent, context: Context): void | Promise<void>;
+    end(message: SettledAssistantMessage, context: Context): void | Promise<void>;
+}
+/** Executable inputs for one already-approved assistant provider request. */
+export interface HarnessAssistantStreamConfig {
+    model: Model<Api>;
+    systemPrompt: string;
+    tools?: Tool[];
+    thinkingLevel: ThinkingLevel;
+    streamOptions: AgentHarnessStreamOptions;
+    transformContext?: (requestContext: {
+        messages: AgentMessage[];
+        systemPrompt: string;
+    }, context: Context) => Promise<{
+        messages: AgentMessage[];
+        systemPrompt: string;
+    }>;
+    toProviderMessages: (messages: AgentMessage[], context: Context) => Message[] | Promise<Message[]>;
+    beforePayload?: (payload: unknown, model: Model<Api>, context: Context) => unknown | undefined | Promise<unknown | undefined>;
+    afterResponse?: (message: SettledAssistantMessage, metadata: AssistantResponseMetadata, context: Context) => Promise<SettledAssistantMessage>;
+    request(aiContext: AiContext, options: SimpleStreamOptions, context: Context): AssistantMessageEventStream | Promise<AssistantMessageEventStream>;
+    observer: AssistantStreamObserver;
+}
+export declare function consumeAssistantStream(stream: AssistantMessageEventStream, observer: AssistantStreamObserver, afterResponse: ((message: SettledAssistantMessage, context: Context) => Promise<SettledAssistantMessage>) | undefined, context: Context): Promise<SettledAssistantMessage>;
+/** Stream one assistant response without mutating the caller's message list. */
+export declare function streamHarnessAssistant(messages: AgentMessage[], config: HarnessAssistantStreamConfig, context: Context): Promise<SettledAssistantMessage>;
+//# sourceMappingURL=assistant.d.ts.map

package/node_modules/@earendil-works/pi-agent-core/dist/harness/execution/assistant.d.ts.map

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

package/node_modules/@earendil-works/pi-agent-core/dist/harness/execution/assistant.js

@@ -0,0 +1,82 @@
+import { getTelemetryContext } from "../context.js";
+import { AbortRequested } from "./effect-gate.js";
+function createRequestOptions(config, captureMetadata, context) {
+    const options = config.streamOptions;
+    return {
+        transport: options.transport,
+        timeoutMs: options.timeoutMs,
+        maxRetries: options.maxRetries,
+        maxRetryDelayMs: options.maxRetryDelayMs,
+        headers: options.headers,
+        metadata: options.metadata,
+        cacheRetention: options.cacheRetention,
+        deferred: options.deferred,
+        ...(config.thinkingLevel === "off" ? {} : { reasoning: config.thinkingLevel }),
+        signal: context.abortSignal,
+        telemetryContext: getTelemetryContext(context),
+        onPayload: config.beforePayload === undefined
+            ? undefined
+            : (payload, model) => config.beforePayload?.(payload, model, context),
+        onResponse: (response) => {
+            captureMetadata({ status: response.status, headers: response.headers });
+        },
+    };
+}
+function isUpdateEvent(event) {
+    return event.type !== "start" && event.type !== "done" && event.type !== "error";
+}
+export async function consumeAssistantStream(stream, observer, afterResponse, context) {
+    let started = false;
+    for await (const event of stream) {
+        if (event.type === "start") {
+            if (started)
+                throw new Error("Assistant message stream emitted more than one start event");
+            started = true;
+            await observer.start({ ...event.partial }, event, context);
+        }
+        else if (isUpdateEvent(event)) {
+            if (!started)
+                throw new Error(`Assistant message stream emitted ${event.type} before start`);
+            await observer.update({ ...event.partial }, event, context);
+        }
+        else if (event.type === "done" && !started) {
+            throw new Error("Assistant message stream emitted done before start");
+        }
+    }
+    const settled = (await stream.result());
+    let finalMessage = settled;
+    if (afterResponse !== undefined) {
+        try {
+            finalMessage = await afterResponse(settled, context);
+        }
+        catch (error) {
+            if (!(error instanceof AbortRequested))
+                throw error;
+            await error.cancellation;
+        }
+    }
+    await observer.end(finalMessage, context);
+    return finalMessage;
+}
+/** Stream one assistant response without mutating the caller's message list. */
+export async function streamHarnessAssistant(messages, config, context) {
+    let requestContext = { messages: messages.slice(), systemPrompt: config.systemPrompt };
+    if (config.transformContext) {
+        requestContext = await config.transformContext(requestContext, context);
+    }
+    const providerMessages = await config.toProviderMessages(requestContext.messages, context);
+    const aiContext = {
+        systemPrompt: requestContext.systemPrompt,
+        messages: providerMessages,
+        tools: config.tools,
+    };
+    let metadata = {};
+    const stream = await config.request(aiContext, createRequestOptions(config, (nextMetadata) => {
+        metadata = nextMetadata;
+    }, context), context);
+    const afterResponse = config.afterResponse;
+    return consumeAssistantStream(stream, config.observer, afterResponse === undefined
+        ? undefined
+        : (message, afterContext) => afterResponse(message, metadata, afterContext), context);
+}
+//# sourceMappingURL=assistant.js.map

package/node_modules/@earendil-works/pi-agent-core/dist/harness/execution/assistant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant.js","sourceRoot":"","sources":["../../../src/harness/execution/assistant.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tContext as AiContext,\n\tApi,\n\tAssistantMessage,\n\tAssistantMessageEvent,\n\tAssistantMessageEventStream,\n\tMessage,\n\tModel,\n\tSimpleStreamOptions,\n\tTool,\n} from \"@earendil-works/pi-ai\";\nimport type { AgentMessage, ThinkingLevel } from \"../../types.ts\";\nimport { type Context, getTelemetryContext } from \"../context.ts\";\nimport type { SettledAssistantMessage } from \"../session/types.ts\";\nimport type { AgentHarnessStreamOptions } from \"../types.ts\";\nimport { AbortRequested } from \"./effect-gate.ts\";\n\n/** HTTP response metadata captured before the provider response body is consumed. */\nexport interface AssistantResponseMetadata {\n\tstatus?: number;\n\theaders?: Record<string, string>;\n}\n\n/** Process-local lifecycle observer for one assistant stream. */\nexport interface AssistantStreamObserver {\n\tstart(\n\t\tmessage: AssistantMessage,\n\t\tevent: Extract<AssistantMessageEvent, { type: \"start\" }>,\n\t\tcontext: Context,\n\t): void | Promise<void>;\n\tupdate(message: AssistantMessage, event: AssistantMessageEvent, context: Context): void | Promise<void>;\n\tend(message: SettledAssistantMessage, context: Context): void | Promise<void>;\n}\n\n/** Executable inputs for one already-approved assistant provider request. */\nexport interface HarnessAssistantStreamConfig {\n\tmodel: Model<Api>;\n\tsystemPrompt: string;\n\ttools?: Tool[];\n\tthinkingLevel: ThinkingLevel;\n\tstreamOptions: AgentHarnessStreamOptions;\n\ttransformContext?: (\n\t\trequestContext: { messages: AgentMessage[]; systemPrompt: string },\n\t\tcontext: Context,\n\t) => Promise<{ messages: AgentMessage[]; systemPrompt: string }>;\n\ttoProviderMessages: (messages: AgentMessage[], context: Context) => Message[] | Promise<Message[]>;\n\tbeforePayload?: (\n\t\tpayload: unknown,\n\t\tmodel: Model<Api>,\n\t\tcontext: Context,\n\t) => unknown | undefined | Promise<unknown | undefined>;\n\tafterResponse?: (\n\t\tmessage: SettledAssistantMessage,\n\t\tmetadata: AssistantResponseMetadata,\n\t\tcontext: Context,\n\t) => Promise<SettledAssistantMessage>;\n\trequest(\n\t\taiContext: AiContext,\n\t\toptions: SimpleStreamOptions,\n\t\tcontext: Context,\n\t): AssistantMessageEventStream | Promise<AssistantMessageEventStream>;\n\tobserver: AssistantStreamObserver;\n}\n\nfunction createRequestOptions(\n\tconfig: HarnessAssistantStreamConfig,\n\tcaptureMetadata: (metadata: AssistantResponseMetadata) => void,\n\tcontext: Context,\n): SimpleStreamOptions {\n\tconst options = config.streamOptions;\n\treturn {\n\t\ttransport: options.transport,\n\t\ttimeoutMs: options.timeoutMs,\n\t\tmaxRetries: options.maxRetries,\n\t\tmaxRetryDelayMs: options.maxRetryDelayMs,\n\t\theaders: options.headers,\n\t\tmetadata: options.metadata,\n\t\tcacheRetention: options.cacheRetention,\n\t\tdeferred: options.deferred,\n\t\t...(config.thinkingLevel === \"off\" ? {} : { reasoning: config.thinkingLevel }),\n\t\tsignal: context.abortSignal,\n\t\ttelemetryContext: getTelemetryContext(context),\n\t\tonPayload:\n\t\t\tconfig.beforePayload === undefined\n\t\t\t\t? undefined\n\t\t\t\t: (payload, model) => config.beforePayload?.(payload, model, context),\n\t\tonResponse: (response) => {\n\t\t\tcaptureMetadata({ status: response.status, headers: response.headers });\n\t\t},\n\t};\n}\n\nfunction isUpdateEvent(\n\tevent: AssistantMessageEvent,\n): event is Exclude<AssistantMessageEvent, { type: \"start\" | \"done\" | \"error\" }> {\n\treturn event.type !== \"start\" && event.type !== \"done\" && event.type !== \"error\";\n}\n\nexport async function consumeAssistantStream(\n\tstream: AssistantMessageEventStream,\n\tobserver: AssistantStreamObserver,\n\tafterResponse:\n\t\t| ((message: SettledAssistantMessage, context: Context) => Promise<SettledAssistantMessage>)\n\t\t| undefined,\n\tcontext: Context,\n): Promise<SettledAssistantMessage> {\n\tlet started = false;\n\tfor await (const event of stream) {\n\t\tif (event.type === \"start\") {\n\t\t\tif (started) throw new Error(\"Assistant message stream emitted more than one start event\");\n\t\t\tstarted = true;\n\t\t\tawait observer.start({ ...event.partial }, event, context);\n\t\t} else if (isUpdateEvent(event)) {\n\t\t\tif (!started) throw new Error(`Assistant message stream emitted ${event.type} before start`);\n\t\t\tawait observer.update({ ...event.partial }, event, context);\n\t\t} else if (event.type === \"done\" && !started) {\n\t\t\tthrow new Error(\"Assistant message stream emitted done before start\");\n\t\t}\n\t}\n\n\tconst settled = (await stream.result()) as SettledAssistantMessage;\n\tlet finalMessage = settled;\n\tif (afterResponse !== undefined) {\n\t\ttry {\n\t\t\tfinalMessage = await afterResponse(settled, context);\n\t\t} catch (error) {\n\t\t\tif (!(error instanceof AbortRequested)) throw error;\n\t\t\tawait error.cancellation;\n\t\t}\n\t}\n\tawait observer.end(finalMessage, context);\n\treturn finalMessage;\n}\n\n/** Stream one assistant response without mutating the caller's message list. */\nexport async function streamHarnessAssistant(\n\tmessages: AgentMessage[],\n\tconfig: HarnessAssistantStreamConfig,\n\tcontext: Context,\n): Promise<SettledAssistantMessage> {\n\tlet requestContext = { messages: messages.slice(), systemPrompt: config.systemPrompt };\n\tif (config.transformContext) {\n\t\trequestContext = await config.transformContext(requestContext, context);\n\t}\n\n\tconst providerMessages = await config.toProviderMessages(requestContext.messages, context);\n\tconst aiContext: AiContext = {\n\t\tsystemPrompt: requestContext.systemPrompt,\n\t\tmessages: providerMessages,\n\t\ttools: config.tools,\n\t};\n\n\tlet metadata: AssistantResponseMetadata = {};\n\tconst stream = await config.request(\n\t\taiContext,\n\t\tcreateRequestOptions(\n\t\t\tconfig,\n\t\t\t(nextMetadata) => {\n\t\t\t\tmetadata = nextMetadata;\n\t\t\t},\n\t\t\tcontext,\n\t\t),\n\t\tcontext,\n\t);\n\n\tconst afterResponse = config.afterResponse;\n\treturn consumeAssistantStream(\n\t\tstream,\n\t\tconfig.observer,\n\t\tafterResponse === undefined\n\t\t\t? undefined\n\t\t\t: (message, afterContext) => afterResponse(message, metadata, afterContext),\n\t\tcontext,\n\t);\n}\n"]}

package/node_modules/@earendil-works/pi-agent-core/dist/harness/execution/effect-gate.d.ts

@@ -0,0 +1,22 @@
+/** Expected internal control flow when cancellation wins effect admission. */
+export declare class AbortRequested extends Error {
+    readonly cancellation: Promise<void>;
+    constructor(cancellation: Promise<void>);
+}
+/** Procedure-facing synchronous admission capability for one drive pass. */
+export interface Gate {
+    readonly signal: AbortSignal;
+    admit<T>(invoke: () => T): T;
+}
+/** Owner-facing lifecycle controls for one drive pass. */
+export interface GateControl {
+    beginAbort(cancellation: Promise<void>): void;
+    signalAbort(): void;
+    close(error: Error): void;
+}
+/** Create separate procedure-facing and owner-facing views of one effect gate. */
+export declare function createGate(): {
+    gate: Gate;
+    control: GateControl;
+};
+//# sourceMappingURL=effect-gate.d.ts.map

package/node_modules/@earendil-works/pi-agent-core/dist/harness/execution/effect-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-gate.d.ts","sourceRoot":"","sources":["../../../src/harness/execution/effect-gate.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qBAAa,cAAe,SAAQ,KAAK;IACxC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,YAAY,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,EAItC;CACD;AAED,4EAA4E;AAC5E,MAAM,WAAW,IAAI;IACpB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CAC7B;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC3B,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9C,WAAW,IAAI,IAAI,CAAC;IACpB,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC1B;AAOD,kFAAkF;AAClF,wBAAgB,UAAU,IAAI;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAiCjE"}

package/node_modules/@earendil-works/pi-agent-core/dist/harness/execution/effect-gate.js

@@ -0,0 +1,48 @@
+/** Expected internal control flow when cancellation wins effect admission. */
+export class AbortRequested extends Error {
+    constructor(cancellation) {
+        super("Abort requested");
+        this.name = "AbortRequested";
+        this.cancellation = cancellation;
+    }
+}
+/** Create separate procedure-facing and owner-facing views of one effect gate. */
+export function createGate() {
+    let state = { status: "open" };
+    const controller = new AbortController();
+    const check = () => {
+        if (state.status === "aborting")
+            throw new AbortRequested(state.cancellation);
+        if (state.status === "closed")
+            throw state.error;
+    };
+    return {
+        gate: {
+            admit(invoke) {
+                check();
+                return invoke();
+            },
+            signal: controller.signal,
+        },
+        control: {
+            beginAbort(cancellation) {
+                if (state.status !== "open")
+                    return;
+                state = { status: "aborting", cancellation };
+            },
+            signalAbort() {
+                if (state.status !== "aborting" || controller.signal.aborted)
+                    return;
+                controller.abort(new AbortRequested(state.cancellation));
+            },
+            close(error) {
+                if (state.status === "closed")
+                    return;
+                state = { status: "closed", error };
+                if (!controller.signal.aborted)
+                    controller.abort(error);
+            },
+        },
+    };
+}
+//# sourceMappingURL=effect-gate.js.map

package/node_modules/@earendil-works/pi-agent-core/dist/harness/execution/effect-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-gate.js","sourceRoot":"","sources":["../../../src/harness/execution/effect-gate.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGxC,YAAY,YAA2B;QACtC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IAClC,CAAC;CACD;AAoBD,kFAAkF;AAClF,MAAM,UAAU,UAAU;IACzB,IAAI,KAAK,GAAc,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAEzC,MAAM,KAAK,GAAG,GAAS,EAAE;QACxB,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU;YAAE,MAAM,IAAI,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC9E,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC,KAAK,CAAC;IAClD,CAAC,CAAC;IAEF,OAAO;QACN,IAAI,EAAE;YACL,KAAK,CAAI,MAAe;gBACvB,KAAK,EAAE,CAAC;gBACR,OAAO,MAAM,EAAE,CAAC;YACjB,CAAC;YACD,MAAM,EAAE,UAAU,CAAC,MAAM;SACzB;QACD,OAAO,EAAE;YACR,UAAU,CAAC,YAAY;gBACtB,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;oBAAE,OAAO;gBACpC,KAAK,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;YAC9C,CAAC;YACD,WAAW;gBACV,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;oBAAE,OAAO;gBACrE,UAAU,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;YAC1D,CAAC;YACD,KAAK,CAAC,KAAK;gBACV,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;oBAAE,OAAO;gBACtC,KAAK,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;gBACpC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO;oBAAE,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACzD,CAAC;SACD;KACD,CAAC;AACH,CAAC","sourcesContent":["/** Expected internal control flow when cancellation wins effect admission. */\nexport class AbortRequested extends Error {\n\treadonly cancellation: Promise<void>;\n\n\tconstructor(cancellation: Promise<void>) {\n\t\tsuper(\"Abort requested\");\n\t\tthis.name = \"AbortRequested\";\n\t\tthis.cancellation = cancellation;\n\t}\n}\n\n/** Procedure-facing synchronous admission capability for one drive pass. */\nexport interface Gate {\n\treadonly signal: AbortSignal;\n\tadmit<T>(invoke: () => T): T;\n}\n\n/** Owner-facing lifecycle controls for one drive pass. */\nexport interface GateControl {\n\tbeginAbort(cancellation: Promise<void>): void;\n\tsignalAbort(): void;\n\tclose(error: Error): void;\n}\n\ntype GateState =\n\t| { status: \"open\" }\n\t| { status: \"aborting\"; cancellation: Promise<void> }\n\t| { status: \"closed\"; error: Error };\n\n/** Create separate procedure-facing and owner-facing views of one effect gate. */\nexport function createGate(): { gate: Gate; control: GateControl } {\n\tlet state: GateState = { status: \"open\" };\n\tconst controller = new AbortController();\n\n\tconst check = (): void => {\n\t\tif (state.status === \"aborting\") throw new AbortRequested(state.cancellation);\n\t\tif (state.status === \"closed\") throw state.error;\n\t};\n\n\treturn {\n\t\tgate: {\n\t\t\tadmit<T>(invoke: () => T): T {\n\t\t\t\tcheck();\n\t\t\t\treturn invoke();\n\t\t\t},\n\t\t\tsignal: controller.signal,\n\t\t},\n\t\tcontrol: {\n\t\t\tbeginAbort(cancellation) {\n\t\t\t\tif (state.status !== \"open\") return;\n\t\t\t\tstate = { status: \"aborting\", cancellation };\n\t\t\t},\n\t\t\tsignalAbort() {\n\t\t\t\tif (state.status !== \"aborting\" || controller.signal.aborted) return;\n\t\t\t\tcontroller.abort(new AbortRequested(state.cancellation));\n\t\t\t},\n\t\t\tclose(error) {\n\t\t\t\tif (state.status === \"closed\") return;\n\t\t\t\tstate = { status: \"closed\", error };\n\t\t\t\tif (!controller.signal.aborted) controller.abort(error);\n\t\t\t},\n\t\t},\n\t};\n}\n"]}