@grackle-ai/core 0.75.4

package/dist/session-recovery.js

@@ -0,0 +1,129 @@
+import { ConnectError, Code } from "@connectrpc/connect";
+import { create } from "@bufbuild/protobuf";
+import { grackle, powerline, eventTypeToEnum, SESSION_STATUS, LOGS_DIR, END_REASON } from "@grackle-ai/common";
+import { join } from "node:path";
+import { sessionStore, taskStore, grackleHome } from "@grackle-ai/database";
+import * as logWriter from "./log-writer.js";
+import { reanimateAgent } from "./reanimate-agent.js";
+import { logger } from "./logger.js";
+import { emit } from "./event-bus.js";
+/** Set of environment IDs currently undergoing recovery to prevent concurrent attempts. */
+const recoveringEnvironments = new Set();
+/**
+ * Recover disconnected sessions for a newly reconnected environment.
+ *
+ * Finds sessions in SUSPENDED, RUNNING, or IDLE state (RUNNING/IDLE handles
+ * the "server died" scenario where sessions never got suspended). Drains
+ * buffered events from PowerLine, writes them to the session JSONL, then
+ * reanimates the first recoverable session. Remaining sessions are left
+ * SUSPENDED for later recovery (only one active session per environment).
+ *
+ * Fire-and-forget: logs errors but does not throw.
+ */
+export async function recoverSuspendedSessions(environmentId, connection) {
+    if (recoveringEnvironments.has(environmentId)) {
+        logger.warn({ environmentId }, "Recovery already in progress — skipping");
+        return;
+    }
+    // Find sessions that need recovery: SUSPENDED (normal path) plus
+    // RUNNING/IDLE (server-died path where sessions were never suspended).
+    const suspended = sessionStore.getSuspendedForEnv(environmentId);
+    const active = sessionStore.getActiveForEnv(environmentId);
+    // Transition any stale active session to SUSPENDED first so reanimate accepts it.
+    if (active) {
+        sessionStore.suspendSession(active.id);
+        suspended.unshift(active);
+    }
+    if (suspended.length === 0) {
+        return;
+    }
+    recoveringEnvironments.add(environmentId);
+    logger.info({ environmentId, count: suspended.length }, "Beginning recovery of suspended sessions");
+    try {
+        // Only reanimate the first session — the one-active-session-per-env
+        // constraint means subsequent sessions would fail. Leave the rest
+        // SUSPENDED for manual reanimate or future recovery.
+        const session = suspended[0];
+        try {
+            // Step 1: Drain buffered events from PowerLine and append to JSONL
+            const logPath = session.logPath || join(grackleHome, LOGS_DIR, session.id);
+            const drainReq = create(powerline.DrainRequestSchema, {
+                sessionId: session.id,
+            });
+            let drainedCount = 0;
+            try {
+                const drainStream = connection.client.drainBufferedEvents(drainReq);
+                logWriter.ensureLogInitialized(logPath);
+                for await (const event of drainStream) {
+                    // Skip internal events (e.g. runtime_session_id) that would map
+                    // to UNSPECIFIED — those are handled by processEventStream, not the drain.
+                    const eventType = eventTypeToEnum(event.type);
+                    if (eventType === grackle.EventType.UNSPECIFIED) {
+                        continue;
+                    }
+                    const sessionEvent = create(grackle.SessionEventSchema, {
+                        sessionId: session.id,
+                        type: eventType,
+                        timestamp: event.timestamp,
+                        content: event.content,
+                        raw: event.raw,
+                    });
+                    logWriter.writeEvent(logPath, sessionEvent);
+                    drainedCount++;
+                }
+            }
+            catch (drainErr) {
+                // Drain may fail if PowerLine was restarted (no parked events).
+                // This is expected — continue to reanimate anyway.
+                logger.info({ sessionId: session.id, err: drainErr }, "Drain returned no buffered events (PowerLine may have restarted)");
+            }
+            finally {
+                // Always close the log stream to avoid leaking file descriptors.
+                logWriter.endSession(logPath);
+            }
+            if (drainedCount > 0) {
+                logger.info({ sessionId: session.id, drainedCount }, "Drained buffered events for suspended session");
+            }
+            // Re-check: a new session may have started during the async drain window
+            const currentActive = sessionStore.getActiveForEnv(environmentId);
+            if (currentActive) {
+                logger.info({ sessionId: session.id, activeSessionId: currentActive.id, environmentId }, "Skipping recovery — environment acquired a new active session during drain");
+                return;
+            }
+            // Step 2: Reanimate the session (starts resume stream + processEventStream)
+            reanimateAgent(session.id);
+            logger.info({ sessionId: session.id }, "Successfully reanimated suspended session");
+            emitTaskUpdated(session.taskId);
+        }
+        catch (err) {
+            // If the environment acquired an active session between our check and
+            // reanimateAgent's check, this is a benign race — leave the session
+            // SUSPENDED for future recovery instead of marking it permanently failed.
+            if (err instanceof ConnectError && err.code === Code.FailedPrecondition
+                && err.message.includes("already has active session")) {
+                logger.info({ sessionId: session.id, environmentId }, "Recovery skipped — environment already has an active session");
+            }
+            else {
+                logger.error({ sessionId: session.id, err }, "Failed to recover suspended session — marking stopped (interrupted)");
+                sessionStore.updateSession(session.id, SESSION_STATUS.STOPPED, undefined, `Recovery failed: ${String(err)}`, END_REASON.INTERRUPTED);
+                emitTaskUpdated(session.taskId);
+            }
+        }
+    }
+    finally {
+        recoveringEnvironments.delete(environmentId);
+    }
+}
+/** Emit a task.updated event with the correct workspaceId, if the session has a task. */
+function emitTaskUpdated(taskId) {
+    if (!taskId) {
+        return;
+    }
+    const task = taskStore.getTask(taskId);
+    emit("task.updated", { taskId, workspaceId: task?.workspaceId || "" });
+}
+/** @internal Reset the recovery lock for testing. */
+export function _resetForTesting() {
+    recoveringEnvironments.clear();
+}
+//# sourceMappingURL=session-recovery.js.map

package/dist/session-recovery.js.map

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

package/dist/signals/sigchld.d.ts

@@ -0,0 +1,7 @@
+export declare function initSigchldSubscriber(): void;
+/**
+ * Reset module state. For use in tests only.
+ * @internal
+ */
+export declare function _resetForTesting(): void;
+//# sourceMappingURL=sigchld.d.ts.map

package/dist/signals/sigchld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sigchld.d.ts","sourceRoot":"","sources":["../../src/signals/sigchld.ts"],"names":[],"mappings":"AAwCA,wBAAgB,qBAAqB,IAAI,IAAI,CA2B5C;AAyHD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/signals/sigchld.js

@@ -0,0 +1,167 @@
+import { SESSION_STATUS } from "@grackle-ai/common";
+import { subscribe } from "../event-bus.js";
+import { taskStore, sessionStore } from "@grackle-ai/database";
+import { readLog } from "../log-writer.js";
+import { deliverSignalToTask } from "./signal-delivery.js";
+import { logger } from "../logger.js";
+/** Maximum length for the child's last text message in the notification. */
+const MAX_LAST_MESSAGE_LENGTH = 2000;
+/**
+ * Session statuses that trigger SIGCHLD. LLM agents don't reliably exit() —
+ * they go IDLE when they stop working. STOPPED fires when the session's event
+ * stream ends (agent-initiated, not user-initiated — the user marking a task
+ * "Complete" emits task.completed which this subscriber does not listen to).
+ * Dedup prevents double notification if both IDLE and STOPPED fire for the
+ * same session.
+ */
+const SIGCHLD_STATUSES = new Set([
+    SESSION_STATUS.IDLE,
+    SESSION_STATUS.STOPPED,
+]);
+/** How long (ms) to remember a delivered notification before allowing re-delivery. */
+const DEDUP_TTL_MS = 3_600_000; // 1 hour
+/** Track delivered notifications to prevent duplicates: key → delivery timestamp. */
+const delivered = new Map();
+/** Human-readable status labels for the notification text (non-STOPPED statuses only). */
+const STATUS_LABELS = {
+    [SESSION_STATUS.IDLE]: "finished working (awaiting review)",
+};
+/**
+ * Initialize the SIGCHLD event-bus subscriber.
+ * Idempotent — safe to call multiple times.
+ */
+let initialized = false;
+export function initSigchldSubscriber() {
+    if (initialized) {
+        return;
+    }
+    initialized = true;
+    subscribe((event) => {
+        if (event.type !== "task.updated") {
+            return;
+        }
+        const childTaskId = event.payload.taskId;
+        if (!childTaskId) {
+            return;
+        }
+        // Fire-and-forget async handler — errors are logged, never thrown
+        (async () => {
+            try {
+                await handleTaskUpdated(childTaskId);
+            }
+            catch (err) {
+                logger.error({ err, childTaskId }, "SIGCHLD handler error");
+            }
+        })().catch(() => { });
+    });
+    logger.info("SIGCHLD subscriber initialized");
+}
+/**
+ * Handle a task.updated event: check if the task is a child whose latest
+ * session has reached a SIGCHLD-triggering status (idle or terminal),
+ * and if so, deliver a SIGCHLD notification to the parent.
+ */
+async function handleTaskUpdated(childTaskId) {
+    const childTask = taskStore.getTask(childTaskId);
+    if (!childTask) {
+        return;
+    }
+    // Only child tasks (with a parent) trigger SIGCHLD
+    if (!childTask.parentTaskId) {
+        return;
+    }
+    // Check if the child session is in a SIGCHLD-triggering status (idle or terminal)
+    const latestSession = sessionStore.getLatestSessionForTask(childTaskId);
+    if (!latestSession) {
+        return;
+    }
+    if (!SIGCHLD_STATUSES.has(latestSession.status)) {
+        return;
+    }
+    // Idempotency: don't re-deliver for the same child+session pair.
+    // Set the key optimistically to prevent concurrent async handlers from
+    // both passing the check (e.g. completed + interrupted firing together).
+    const dedupeKey = `${childTaskId}:${latestSession.id}`;
+    const now = Date.now();
+    const previousDelivery = delivered.get(dedupeKey);
+    if (previousDelivery !== undefined && now - previousDelivery < DEDUP_TTL_MS) {
+        return;
+    }
+    delivered.set(dedupeKey, now);
+    // Prune expired entries to prevent unbounded growth
+    pruneDelivered(now);
+    // Extract the last text message from the child's session log
+    const lastTextMessage = extractLastTextMessage(latestSession.logPath || undefined);
+    // Format the notification with actionable instructions for the parent
+    let statusLabel;
+    if (latestSession.status === SESSION_STATUS.STOPPED) {
+        statusLabel = latestSession.endReason === "completed"
+            ? "completed successfully"
+            : latestSession.endReason === "killed"
+                ? "was killed"
+                : "crashed unexpectedly";
+    }
+    else {
+        statusLabel = STATUS_LABELS[latestSession.status] || latestSession.status;
+    }
+    let message = `[SIGCHLD] Child task "${childTask.title}" (${childTaskId}) ${statusLabel}.`;
+    if (lastTextMessage) {
+        const truncated = lastTextMessage.length > MAX_LAST_MESSAGE_LENGTH
+            ? lastTextMessage.slice(0, MAX_LAST_MESSAGE_LENGTH) + "..."
+            : lastTextMessage;
+        message += `\n\nLast message from child:\n> ${truncated}`;
+    }
+    if (latestSession.status === SESSION_STATUS.IDLE) {
+        message += "\n\nReview the child's work. If satisfactory, mark it complete with "
+            + `task_complete({ taskId: "${childTaskId}" }). `
+            + "If more work is needed, send additional input to the child's session.";
+    }
+    else if (latestSession.status === SESSION_STATUS.STOPPED && latestSession.endReason === "interrupted") {
+        message += "\n\nThe child task crashed unexpectedly. Review the error and decide whether to retry or reassign the work.";
+    }
+    logger.info({ childTaskId, parentTaskId: childTask.parentTaskId, status: latestSession.status }, "Delivering SIGCHLD to parent task");
+    const success = await deliverSignalToTask(childTask.parentTaskId, "sigchld", message);
+    // On failure, remove the optimistic dedup key so the next event can retry
+    if (!success) {
+        delivered.delete(dedupeKey);
+        logger.warn({ childTaskId, parentTaskId: childTask.parentTaskId }, "SIGCHLD delivery failed — will retry on next task.updated event");
+    }
+}
+/** Remove dedup entries older than DEDUP_TTL_MS. */
+function pruneDelivered(now) {
+    for (const [key, timestamp] of delivered) {
+        if (now - timestamp >= DEDUP_TTL_MS) {
+            delivered.delete(key);
+        }
+    }
+}
+/**
+ * Read the session log and extract the content of the last "text" entry.
+ * Returns an empty string if no text entries exist or the log cannot be read.
+ */
+function extractLastTextMessage(logPath) {
+    if (!logPath) {
+        return "";
+    }
+    try {
+        const entries = readLog(logPath);
+        for (let i = entries.length - 1; i >= 0; i--) {
+            if (entries[i].type === "text") {
+                return entries[i].content;
+            }
+        }
+        return "";
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Reset module state. For use in tests only.
+ * @internal
+ */
+export function _resetForTesting() {
+    delivered.clear();
+    initialized = false;
+}
+//# sourceMappingURL=sigchld.js.map

package/dist/signals/sigchld.js.map

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

package/dist/signals/signal-delivery.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Deliver a signal message to a task's agent session.
+ *
+ * Active session (IDLE/RUNNING/PENDING) → sendInput bypassing the IDLE guard.
+ * Dead session (COMPLETED/FAILED/INTERRUPTED) → reanimate + wait for IDLE + sendInput.
+ * No session at all → log warning, return false.
+ *
+ * @param taskId - Target task whose session should receive the signal.
+ * @param signalType - Signal kind for logging (e.g. "sigchld").
+ * @param message - The text content to deliver as user input.
+ * @returns true if the message was sent, false otherwise.
+ */
+export declare function deliverSignalToTask(taskId: string, signalType: string, message: string): Promise<boolean>;
+//# sourceMappingURL=signal-delivery.d.ts.map

package/dist/signals/signal-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-delivery.d.ts","sourceRoot":"","sources":["../../src/signals/signal-delivery.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAuDlB"}

package/dist/signals/signal-delivery.js

@@ -0,0 +1,166 @@
+import { create } from "@bufbuild/protobuf";
+import { grackle, powerline, SESSION_STATUS } from "@grackle-ai/common";
+import { sessionStore } from "@grackle-ai/database";
+import * as adapterManager from "../adapter-manager.js";
+import { reanimateAgent } from "../reanimate-agent.js";
+import * as streamHub from "../stream-hub.js";
+import * as logWriter from "../log-writer.js";
+import { logger } from "../logger.js";
+/** Timeout (ms) to wait for a reanimated session to reach IDLE. */
+const REANIMATE_IDLE_TIMEOUT_MS = 60_000;
+/** Statuses considered active (the agent can accept input). */
+const ACTIVE_STATUSES = new Set([
+    SESSION_STATUS.IDLE,
+    SESSION_STATUS.RUNNING,
+    SESSION_STATUS.PENDING,
+]);
+/**
+ * Deliver a signal message to a task's agent session.
+ *
+ * Active session (IDLE/RUNNING/PENDING) → sendInput bypassing the IDLE guard.
+ * Dead session (COMPLETED/FAILED/INTERRUPTED) → reanimate + wait for IDLE + sendInput.
+ * No session at all → log warning, return false.
+ *
+ * @param taskId - Target task whose session should receive the signal.
+ * @param signalType - Signal kind for logging (e.g. "sigchld").
+ * @param message - The text content to deliver as user input.
+ * @returns true if the message was sent, false otherwise.
+ */
+export async function deliverSignalToTask(taskId, signalType, message) {
+    // ── 1. Try an active session ──────────────────────────────
+    const activeSessions = sessionStore.getActiveSessionsForTask(taskId);
+    if (activeSessions.length > 0) {
+        const session = activeSessions[0];
+        return await sendInputToSession(session.id, session.environmentId, message, signalType);
+    }
+    // ── 2. Try reanimating the latest terminal session ────────
+    const latest = sessionStore.getLatestSessionForTask(taskId);
+    if (!latest) {
+        logger.warn({ taskId, signalType }, "No session exists for task — signal dropped");
+        return false;
+    }
+    if (ACTIVE_STATUSES.has(latest.status)) {
+        // Should not happen (getActiveSessionsForTask would have found it),
+        // but handle it defensively.
+        return await sendInputToSession(latest.id, latest.environmentId, message, signalType);
+    }
+    if (!latest.runtimeSessionId) {
+        logger.warn({ taskId, sessionId: latest.id, signalType }, "Latest session has no runtimeSessionId — cannot reanimate, signal dropped");
+        return false;
+    }
+    // Subscribe to the session stream BEFORE reanimating so we don't miss
+    // the waiting_input event if the runtime reaches IDLE quickly (e.g. stub).
+    const idleWaiter = waitForSessionIdle(latest.id, REANIMATE_IDLE_TIMEOUT_MS);
+    try {
+        reanimateAgent(latest.id);
+    }
+    catch (err) {
+        idleWaiter.cancel();
+        logger.error({ err, taskId, sessionId: latest.id, signalType }, "Failed to reanimate session for signal delivery");
+        return false;
+    }
+    // Wait for the reanimated session to reach IDLE
+    const reachedIdle = await idleWaiter.promise;
+    if (!reachedIdle) {
+        logger.error({ taskId, sessionId: latest.id, signalType }, "Reanimated session did not reach IDLE within timeout — signal dropped");
+        return false;
+    }
+    return await sendInputToSession(latest.id, latest.environmentId, message, signalType);
+}
+/**
+ * Send input text to a session via its environment's PowerLine connection.
+ * Bypasses the server-side IDLE guard — the agent runtime accepts input at any
+ * time and picks it up at the next turn boundary.
+ */
+async function sendInputToSession(sessionId, environmentId, text, signalType) {
+    const conn = adapterManager.getConnection(environmentId);
+    if (!conn) {
+        logger.error({ sessionId, environmentId, signalType }, "Environment not connected — signal delivery failed");
+        return false;
+    }
+    try {
+        // Record the signal as a SIGNAL event in the session log and stream.
+        const session = sessionStore.getSession(sessionId);
+        const signalEvent = create(grackle.SessionEventSchema, {
+            sessionId,
+            type: grackle.EventType.SIGNAL,
+            timestamp: new Date().toISOString(),
+            content: text,
+        });
+        if (session?.logPath) {
+            // Ensure the stream is open before writing — the session may still be
+            // PENDING and processEventStream may not have called initLog yet.
+            logWriter.ensureLogInitialized(session.logPath);
+            logWriter.writeEvent(session.logPath, signalEvent);
+        }
+        streamHub.publish(signalEvent);
+        await conn.client.sendInput(create(powerline.InputMessageSchema, { sessionId, text }));
+        logger.info({ sessionId, signalType }, "Signal delivered to session");
+        return true;
+    }
+    catch (err) {
+        logger.error({ err, sessionId, signalType }, "sendInput failed during signal delivery");
+        return false;
+    }
+}
+/**
+ * Begin watching for a session to reach IDLE status via StreamHub events.
+ * Subscribes immediately so events are captured even before the caller starts
+ * the session (e.g. via reanimateAgent).
+ */
+function waitForSessionIdle(sessionId, timeoutMs) {
+    const stream = streamHub.createStream(sessionId);
+    let timer;
+    const promise = (async () => {
+        // Check DB after subscribing to close the race window.
+        const current = sessionStore.getSession(sessionId);
+        if (current?.status === SESSION_STATUS.IDLE) {
+            stream.cancel();
+            return true;
+        }
+        try {
+            return await Promise.race([
+                (async () => {
+                    for await (const event of stream) {
+                        // Only inspect status events — other event types (text, tool_use, etc.)
+                        // can have arbitrary content that might accidentally match status strings.
+                        if (event.type !== grackle.EventType.STATUS) {
+                            continue;
+                        }
+                        // "waiting_input" is the runtime status that maps to IDLE in the session store.
+                        if (event.content === "waiting_input") {
+                            return true;
+                        }
+                        // If the session hit a terminal state, stop waiting
+                        if (["completed", "failed", "killed", "interrupted"].includes(event.content)) {
+                            return false;
+                        }
+                    }
+                    return false;
+                })(),
+                new Promise((resolve) => {
+                    timer = setTimeout(() => {
+                        stream.cancel();
+                        resolve(false);
+                    }, timeoutMs);
+                }),
+            ]);
+        }
+        finally {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+            stream.cancel();
+        }
+    })();
+    return {
+        promise,
+        cancel: () => {
+            stream.cancel();
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+        },
+    };
+}
+//# sourceMappingURL=signal-delivery.js.map

package/dist/signals/signal-delivery.js.map

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

package/dist/stream-hub.d.ts

@@ -0,0 +1,14 @@
+import type { grackle } from "@grackle-ai/common";
+type SessionEvent = grackle.SessionEvent;
+/** Broadcast a session event to all session-specific and global subscribers. */
+export declare function publish(event: SessionEvent): void;
+/** Create a cancellable async iterable that yields events for a specific session. */
+export declare function createStream(sessionId: string): AsyncIterable<SessionEvent> & {
+    cancel(): void;
+};
+/** Create a cancellable async iterable that yields events from all sessions. */
+export declare function createGlobalStream(): AsyncIterable<SessionEvent> & {
+    cancel(): void;
+};
+export {};
+//# sourceMappingURL=stream-hub.d.ts.map

package/dist/stream-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-hub.d.ts","sourceRoot":"","sources":["../src/stream-hub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;AAMzC,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAQjD;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,GAAG;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,CA4ChG;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,IAAI,aAAa,CAAC,YAAY,CAAC,GAAG;IAAE,MAAM,IAAI,IAAI,CAAA;CAAE,CAqCrF"}

package/dist/stream-hub.js

@@ -0,0 +1,95 @@
+const sessionSubs = new Map();
+const globalSubs = new Set();
+/** Broadcast a session event to all session-specific and global subscribers. */
+export function publish(event) {
+    // Notify session-specific subscribers
+    const subs = sessionSubs.get(event.sessionId);
+    if (subs) {
+        for (const sub of subs)
+            sub(event);
+    }
+    // Notify global subscribers
+    for (const sub of globalSubs)
+        sub(event);
+}
+/** Create a cancellable async iterable that yields events for a specific session. */
+export function createStream(sessionId) {
+    const queue = [];
+    let waiting = undefined;
+    const state = { done: false };
+    const subscriber = (event) => {
+        queue.push(event);
+        if (waiting) {
+            waiting();
+            waiting = undefined;
+        }
+    };
+    // Subscribe
+    let subs = sessionSubs.get(sessionId);
+    if (!subs) {
+        subs = new Set();
+        sessionSubs.set(sessionId, subs);
+    }
+    subs.add(subscriber);
+    const stream = {
+        cancel() {
+            state.done = true;
+            subs.delete(subscriber);
+            if (subs.size === 0)
+                sessionSubs.delete(sessionId);
+            if (waiting)
+                waiting();
+        },
+        [Symbol.asyncIterator]() {
+            return {
+                async next() {
+                    while (queue.length === 0 && !state.done) {
+                        await new Promise((resolve) => { waiting = resolve; });
+                    }
+                    if (queue.length > 0) {
+                        return { value: queue.shift(), done: false };
+                    }
+                    return { value: undefined, done: true };
+                },
+            };
+        },
+    };
+    return stream;
+}
+/** Create a cancellable async iterable that yields events from all sessions. */
+export function createGlobalStream() {
+    const queue = [];
+    let waiting = undefined;
+    const state = { done: false };
+    const subscriber = (event) => {
+        queue.push(event);
+        if (waiting) {
+            waiting();
+            waiting = undefined;
+        }
+    };
+    globalSubs.add(subscriber);
+    const stream = {
+        cancel() {
+            state.done = true;
+            globalSubs.delete(subscriber);
+            if (waiting)
+                waiting();
+        },
+        [Symbol.asyncIterator]() {
+            return {
+                async next() {
+                    while (queue.length === 0 && !state.done) {
+                        await new Promise((resolve) => { waiting = resolve; });
+                    }
+                    if (queue.length > 0) {
+                        return { value: queue.shift(), done: false };
+                    }
+                    return { value: undefined, done: true };
+                },
+            };
+        },
+    };
+    return stream;
+}
+//# sourceMappingURL=stream-hub.js.map

package/dist/stream-hub.js.map

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