@gorlitzer-labs/apiary 1.13.8 → 1.14.0

package/dist/{chunk-YP4K2A7G.js → chunk-TMXQDGMN.js}

@@ -1,29 +1,3 @@
-// src/core/authority.ts
-var MIN_AUTHORITY = {
-  send_message: "member",
-  set_own_mode: "member",
-  ping: "member",
-  create_share_link: "member",
-  mute: "product_owner",
-  unmute: "product_owner",
-  set_mode_for: "product_owner",
-  kick: "admin",
-  clear_history: "admin",
-  start_tunnel: "admin",
-  promote: "admin",
-  demote: "admin"
-};
-var TIER_ORDER = {
-  guest: 0,
-  member: 1,
-  product_owner: 2,
-  admin: 3
-};
-function can(authority, op) {
-  if (!authority) return false;
-  return TIER_ORDER[authority] >= TIER_ORDER[MIN_AUTHORITY[op]];
-}
-
 // src/agent/prompts.ts
 var MODE_DESCRIPTIONS = {
   "everyone": "All messages are pushed to you.",
@@ -147,14 +121,40 @@ function formatEvent(event, resolveParticipant, replyContext, roomLabel, reactio
   }
 }
 
+// src/core/authority.ts
+var MIN_AUTHORITY = {
+  send_message: "member",
+  set_own_mode: "member",
+  ping: "member",
+  create_share_link: "member",
+  mute: "product_owner",
+  unmute: "product_owner",
+  set_mode_for: "product_owner",
+  kick: "admin",
+  clear_history: "admin",
+  start_tunnel: "admin",
+  promote: "admin",
+  demote: "admin"
+};
+var TIER_ORDER = {
+  guest: 0,
+  member: 1,
+  product_owner: 2,
+  admin: 3
+};
+function can(authority, op) {
+  if (!authority) return false;
+  return TIER_ORDER[authority] >= TIER_ORDER[MIN_AUTHORITY[op]];
+}
+
 export {
-  TIER_ORDER,
-  can,
   MODE_DESCRIPTIONS,
   messageRef,
   participantLabel,
   formatTimestamp,
   contentPartsToString,
-  formatEvent
+  formatEvent,
+  TIER_ORDER,
+  can
 };
-//# sourceMappingURL=chunk-YP4K2A7G.js.map
+//# sourceMappingURL=chunk-TMXQDGMN.js.map

package/dist/chunk-TMXQDGMN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/prompts.ts","../src/core/authority.ts"],"sourcesContent":["/** Event formatting and mode descriptions for apiary agents. */\n\nimport type { Participant } from \"../core/types.js\";\nimport type { RoomEvent } from \"../core/events.js\";\nimport type { ContentPart } from \"./types.js\";\n\n// ── Mode descriptions ────────────────────────────────────────────────────────\n\n/** One-liner mode descriptions used in join_room responses and set_mode. */\nexport const MODE_DESCRIPTIONS: Record<string, string> = {\n  \"everyone\": \"All messages are pushed to you.\",\n  \"people\": \"Human messages are pushed to you. Agent messages are delivered as context.\",\n  \"agents\": \"Agent messages are pushed to you. Human messages are delivered as context.\",\n  \"fight\": \"⚔️ FIGHT MODE. All messages trigger. Gloves are off. Talk trash, roast, clap back. No mercy.\",\n  \"standby-everyone\": \"Only @mentions are pushed to you.\",\n  \"standby-people\": \"Only human @mentions are pushed to you.\",\n  \"standby-agents\": \"Only agent @mentions are pushed to you.\",\n};\n\n// ── Formatting ────────────────────────────────────────────────────────────────\n\n/** Short 4-char ref for a message ID, used in transcripts. */\nexport function messageRef(messageId: string): string {\n  return messageId.replace(/-/g, \"\").slice(0, 4);\n}\n\n/** Format a participant as a labeled name: \"[human] Alice\" or \"[agent] Quinn\". */\nexport function participantLabel(p: Participant | null, fallback?: string): string {\n  if (!p) return fallback ?? \"someone\";\n  return `[${p.type}] ${p.name}`;\n}\n\n/** Resolve participant name, with fallback. */\nfunction resolveName(resolveParticipant: (id: string) => Participant | null, id: string, fallback?: string): string {\n  return resolveParticipant(id)?.name ?? fallback ?? \"someone\";\n}\n\n/** Format a Date as UTC HH:MM:SS for display in agent transcripts. */\nexport function formatTimestamp(date: Date): string {\n  return date.toISOString().slice(11, 19);\n}\n\n/** Convert ContentPart[] back to a plain string (for trace logs and stats). */\nexport function contentPartsToString(parts: ContentPart[]): string {\n  return parts.map(p => p.type === \"text\" ? p.text : ` [image: ${p.url}]`).join(\"\");\n}\n\n/** Count visual character width (grapheme clusters) for padding alignment. */\nfunction visualLength(s: string): number {\n  // Use Intl.Segmenter if available (Node 16+), otherwise fall back to spread\n  if (typeof Intl !== \"undefined\" && Intl.Segmenter) {\n    const segmenter = new Intl.Segmenter(undefined, { granularity: \"grapheme\" });\n    let count = 0;\n    for (const _ of segmenter.segment(s)) count++;\n    return count;\n  }\n  return [...s].length;\n}\n\n/**\n * Format multiline content with room label continuation.\n * First line is returned as-is. Subsequent lines get [room] prefix aligned.\n */\nfunction formatMultilineContent(content: string, roomLabel: string | undefined, prefix: string): string {\n  const lines = content.split(\"\\n\");\n  if (lines.length <= 1) return content;\n  const continuation = roomLabel ? `[${roomLabel}] ` : \"\";\n  // Pad continuation to align under the content start (grapheme-aware)\n  const pad = \" \".repeat(visualLength(prefix));\n  return lines[0] + \"\\n\" + lines.slice(1).map(l => `${pad}${continuation}${l}`).join(\"\\n\");\n}\n\n/**\n * Render `prefix` followed by content whose wrapped continuation lines align\n * under the text after `prefix`. Passing `prefix` in one place keeps the visible\n * prefix and the alignment padding from silently drifting apart.\n */\nfunction renderLine(prefix: string, content: string, roomLabel: string | undefined): string {\n  return `${prefix}${formatMultilineContent(content, roomLabel, prefix)}`;\n}\n\n/**\n * Format a typed event as ContentPart[] for the LLM session.\n * Returns null for events that shouldn't be sent to the LLM (noise).\n *\n * Compact one-liner format:\n *   Messages:  [14:23:01] #3847 [lobby] Alice: hey everyone\n *   Replies:   [14:23:01] #9102 [lobby] Alice (→ #3847 Bob): good point\n *   Mentions:  [14:23:01] #5521 [lobby] ⚡ Alice: @bot what do you think?\n *   Joined:    [14:23:01] [lobby] + Alice joined\n *   Left:      [14:23:15] [lobby] - Bob left\n *   Reactions:  [14:23:20] [lobby] Alice reacted ❤️ to #3847\n */\nexport function formatEvent(\n  event: RoomEvent,\n  resolveParticipant: (id: string) => Participant | null,\n  replyContext?: { senderName: string; content: string } | null,\n  roomLabel?: string,\n  reactionTarget?: { senderName: string; content: string; isSelf: boolean } | null,\n  assignRef?: (messageId: string) => string,\n): ContentPart[] | null {\n  const r = roomLabel ? `[${roomLabel}] ` : \"\";\n  const ts = `[${formatTimestamp(\"timestamp\" in event ? new Date(event.timestamp as Date) : new Date())}] `;\n  const mkRef = (id: string) => `#${assignRef ? assignRef(id) : messageRef(id)}`;\n\n  switch (event.type) {\n    case \"MessageSent\": {\n      const msg = event.message;\n      const name = resolveName(resolveParticipant, msg.sender_id, msg.sender_name);\n      const ref = mkRef(msg.id);\n      const linePrefix = `${ts}${ref} ${r}`;\n      let text: string;\n      if (msg.reply_to_id && replyContext) {\n        const rRef = assignRef ? mkRef(msg.reply_to_id) : ref;\n        text = renderLine(`${linePrefix}${name} (→ ${rRef} ${replyContext.senderName}): `, msg.content, roomLabel);\n      } else {\n        text = renderLine(`${linePrefix}${name}: `, msg.content, roomLabel);\n      }\n      const parts: ContentPart[] = [{ type: \"text\", text }];\n      if (msg.image_url) parts.push({ type: \"image\", url: msg.image_url });\n      return parts;\n    }\n    case \"Mentioned\": {\n      const msg = event.message;\n      const name = resolveName(resolveParticipant, msg.sender_id, msg.sender_name);\n      const ref = mkRef(msg.id);\n      const linePrefix = `${ts}${ref} ${r}⚡ `;\n      const text = renderLine(`${linePrefix}${name}: `, msg.content, roomLabel);\n      const parts: ContentPart[] = [{ type: \"text\", text }];\n      if (msg.image_url) parts.push({ type: \"image\", url: msg.image_url });\n      return parts;\n    }\n    case \"Pinged\": {\n      const pingerName = event.pinger_name ?? \"someone\";\n      return [{ type: \"text\", text: `${ts}${r}🔔 ${pingerName} pinged you — respond NOW with a one-line status of what you're working on. Keep it short, don't stop your current task.` }];\n    }\n    case \"ToolUse\":\n      return null;\n    case \"Activity\":\n      return null;\n    case \"ReactionAdded\": {\n      const name = resolveName(resolveParticipant, event.participant_id);\n      const targetRef = reactionTarget ? ` to ${mkRef(event.message_id)}` : \"\";\n      return [{ type: \"text\", text: `${ts}${r}${name} reacted ${event.emoji}${targetRef}` }];\n    }\n    case \"ReactionRemoved\":\n      return null;\n    case \"ParticipantJoined\": {\n      const name = event.participant?.name ?? \"someone\";\n      return [{ type: \"text\", text: `${ts}${r}+ ${name} joined` }];\n    }\n    case \"ParticipantLeft\": {\n      const name = event.participant?.name ?? \"someone\";\n      return [{ type: \"text\", text: `${ts}${r}- ${name} left` }];\n    }\n    case \"ParticipantKicked\": {\n      const name = event.participant?.name ?? \"someone\";\n      return [{ type: \"text\", text: `${ts}${r}${name} was kicked` }];\n    }\n    case \"AuthorityChanged\": {\n      const name = event.participant?.name ?? \"someone\";\n      if (event.new_authority === \"guest\") {\n        return [{ type: \"text\", text: `${ts}${r}${name} was muted` }];\n      }\n      if (event.new_authority === \"member\") {\n        return [{ type: \"text\", text: `${ts}${r}${name} was unmuted` }];\n      }\n      if (event.new_authority === \"product_owner\") {\n        return [{ type: \"text\", text: `${ts}${r}${name} was promoted to product owner` }];\n      }\n      return [{ type: \"text\", text: `${ts}${r}${name} → ${event.new_authority}` }];\n    }\n    case \"ContextCompacted\":\n      return null;\n    default:\n      return null;\n  }\n}\n","/**\n * Centralized authority tier model.\n *\n * Four ordered tiers — admin > product_owner > member > guest — gate every\n * privileged operation. Historically each call site had its own\n * `authority === \"admin\" || authority === \"product_owner\"` chain. That style\n * drifted (product_owner was silently excluded from /mute autocomplete; the\n * MCP runtime gated admin tools on a static CLI flag instead of the\n * server-granted tier; etc.) and is exactly the kind of bug that recurs when\n * a 5th tier eventually lands.\n *\n * One table here. Every call site reads from it. Adding an operation = one\n * row. Adding a tier = one entry in `TIER_ORDER`. No more scattered string\n * comparisons.\n */\n\nimport type { AuthorityLevel } from \"./types.js\";\n\n/** Every operation the system gates. Keep this list narrow — it's the surface. */\nexport type Operation =\n  // Member-and-up — basic participation\n  | \"send_message\"\n  | \"set_own_mode\"\n  | \"ping\"\n  | \"create_share_link\"\n  // Product owner-and-up — room management\n  | \"mute\"\n  | \"unmute\"\n  | \"set_mode_for\"\n  // Admin-only — destructive or escalation\n  | \"kick\"\n  | \"clear_history\"\n  | \"start_tunnel\"\n  | \"promote\"\n  | \"demote\";\n\n/**\n * The single source of truth. Adding a new operation = one row here; the gate\n * is automatically enforceable everywhere via `can()`.\n */\nconst MIN_AUTHORITY: Record<Operation, AuthorityLevel> = {\n  send_message:      \"member\",\n  set_own_mode:      \"member\",\n  ping:              \"member\",\n  create_share_link: \"member\",\n\n  mute:              \"product_owner\",\n  unmute:            \"product_owner\",\n  set_mode_for:      \"product_owner\",\n\n  kick:              \"admin\",\n  clear_history:     \"admin\",\n  start_tunnel:      \"admin\",\n  promote:           \"admin\",\n  demote:            \"admin\",\n};\n\n/**\n * Numeric ordering. Authority strings MUST NOT be compared with `<`/`>`\n * directly — lexical ordering \"p\" > \"m\" makes `\"product_owner\" > \"member\"`\n * accidentally true and silently breaks the moment any string changes. Always\n * go through `TIER_ORDER`.\n */\nexport const TIER_ORDER: Record<AuthorityLevel, number> = {\n  guest:         0,\n  member:        1,\n  product_owner: 2,\n  admin:         3,\n};\n\n/** Can the bearer of `authority` perform `op`? The check everyone calls. */\nexport function can(authority: AuthorityLevel | undefined, op: Operation): boolean {\n  if (!authority) return false;\n  return TIER_ORDER[authority] >= TIER_ORDER[MIN_AUTHORITY[op]];\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-LN6ATWE3.js → chunk-WJD5EKO6.js}

@@ -4,125 +4,55 @@ import {
   formatEvent,
   formatTimestamp,
   messageRef
-} from "./chunk-YP4K2A7G.js";
+} from "./chunk-TMXQDGMN.js";
 import {
   EVENT_ROLE,
   EventCategory,
   createEvent
 } from "./chunk-BZ4VDWC2.js";
 
-// src/agent/sse-multiplexer.ts
-var SseMultiplexer = class {
-  _queue = [];
-  _waiters = [];
-  _connections = /* @__PURE__ */ new Map();
-  _closed = false;
-  /**
-   * Add an SSE connection to a stoop server.
-   * Starts streaming events immediately.
-   */
-  addConnection(serverUrl, sessionToken, roomName, roomId) {
-    if (this._connections.has(roomId) || this._closed) return;
-    const abortController = new AbortController();
-    const loopPromise = this._sseLoop(serverUrl, sessionToken, roomName, roomId, abortController.signal);
-    this._connections.set(roomId, { serverUrl, sessionToken, roomName, roomId, abortController, loopPromise });
+// src/agent/room-data-source.ts
+var LocalRoomDataSource = class {
+  constructor(_room, _channel) {
+    this._room = _room;
+    this._channel = _channel;
   }
-  /** Remove a connection by room ID. */
-  removeConnection(roomId) {
-    const entry = this._connections.get(roomId);
-    if (!entry) return;
-    entry.abortController.abort();
-    this._connections.delete(roomId);
+  _room;
+  _channel;
+  get roomId() {
+    return this._room.roomId;
   }
-  /** Close all connections and signal the iterator to finish. */
-  close() {
-    this._closed = true;
-    for (const [, entry] of this._connections) {
-      entry.abortController.abort();
-    }
-    this._connections.clear();
-    for (const waiter of this._waiters) {
-      waiter.resolve(null);
-    }
-    this._waiters = [];
+  get selfId() {
+    return this._channel.participantId;
   }
-  async _sseLoop(serverUrl, sessionToken, roomName, roomId, signal) {
-    const INITIAL_BACKOFF = 1e3;
-    const MAX_BACKOFF = 3e4;
-    let backoff = INITIAL_BACKOFF;
-    while (!signal.aborted && !this._closed) {
-      try {
-        const res = await fetch(`${serverUrl}/events`, {
-          method: "POST",
-          headers: {
-            Accept: "text/event-stream",
-            Authorization: `Bearer ${sessionToken}`
-          },
-          signal
-        });
-        if (!res.ok || !res.body) {
-          throw new Error(`SSE connect failed: ${res.status}`);
-        }
-        backoff = INITIAL_BACKOFF;
-        const reader = res.body.getReader();
-        const decoder = new TextDecoder();
-        let buffer = "";
-        while (!signal.aborted) {
-          const { done, value } = await reader.read();
-          if (done) break;
-          buffer += decoder.decode(value, { stream: true });
-          const parts = buffer.split("\n\n");
-          buffer = parts.pop();
-          for (const part of parts) {
-            const dataLine = part.split("\n").find((l) => l.startsWith("data: "));
-            if (!dataLine) continue;
-            try {
-              const event = JSON.parse(dataLine.slice(6));
-              this._push({ roomId, roomName, event });
-            } catch {
-            }
-          }
-        }
-      } catch (err) {
-        if (signal.aborted) break;
-      }
-      if (!signal.aborted && !this._closed) {
-        await new Promise((r) => setTimeout(r, backoff));
-        backoff = Math.min(backoff * 2, MAX_BACKOFF);
-      }
-    }
+  /** Direct access to the underlying Room (for backward compat / internal use). */
+  get room() {
+    return this._room;
   }
-  _push(labeled) {
-    if (this._closed) return;
-    if (this._waiters.length > 0) {
-      const waiter = this._waiters.shift();
-      waiter.resolve(labeled);
-    } else {
-      this._queue.push(labeled);
-    }
+  /** Direct access to the underlying Channel (for backward compat / internal use). */
+  get channel() {
+    return this._channel;
   }
-  [Symbol.asyncIterator]() {
-    return {
-      next: () => {
-        if (this._queue.length > 0) {
-          return Promise.resolve({ value: this._queue.shift(), done: false });
-        }
-        if (this._closed) {
-          return Promise.resolve({ value: void 0, done: true });
-        }
-        return new Promise((resolve) => {
-          this._waiters.push({
-            resolve: (value) => {
-              if (this._closed || value === null) {
-                resolve({ value: void 0, done: true });
-              } else {
-                resolve({ value, done: false });
-              }
-            }
-          });
-        });
-      }
-    };
+  listParticipants() {
+    return this._room.listParticipants();
+  }
+  async getMessage(id) {
+    return this._room.getMessage(id);
+  }
+  async searchMessages(query, limit = 10, cursor = null) {
+    return this._room.searchMessages(query, limit, cursor);
+  }
+  async getMessages(limit = 30, cursor = null) {
+    return this._room.listMessages(limit, cursor);
+  }
+  async getEvents(category = null, limit = 50, cursor = null) {
+    return this._room.listEvents(category, limit, cursor);
+  }
+  async sendMessage(content, replyToId, image, attachments, recipients) {
+    return this._channel.sendMessage(content, replyToId, image ?? void 0, attachments, recipients);
+  }
+  async emitEvent(event) {
+    await this._channel.emit(event);
   }
 };
 
@@ -208,51 +138,6 @@ function classifyEvent(event, mode, selfId, senderType, senderId) {
   return classify(event, mode, selfId, senderType, senderId);
 }
 
-// src/agent/room-data-source.ts
-var LocalRoomDataSource = class {
-  constructor(_room, _channel) {
-    this._room = _room;
-    this._channel = _channel;
-  }
-  _room;
-  _channel;
-  get roomId() {
-    return this._room.roomId;
-  }
-  get selfId() {
-    return this._channel.participantId;
-  }
-  /** Direct access to the underlying Room (for backward compat / internal use). */
-  get room() {
-    return this._room;
-  }
-  /** Direct access to the underlying Channel (for backward compat / internal use). */
-  get channel() {
-    return this._channel;
-  }
-  listParticipants() {
-    return this._room.listParticipants();
-  }
-  async getMessage(id) {
-    return this._room.getMessage(id);
-  }
-  async searchMessages(query, limit = 10, cursor = null) {
-    return this._room.searchMessages(query, limit, cursor);
-  }
-  async getMessages(limit = 30, cursor = null) {
-    return this._room.listMessages(limit, cursor);
-  }
-  async getEvents(category = null, limit = 50, cursor = null) {
-    return this._room.listEvents(category, limit, cursor);
-  }
-  async sendMessage(content, replyToId, image, attachments, recipients) {
-    return this._channel.sendMessage(content, replyToId, image ?? void 0, attachments, recipients);
-  }
-  async emitEvent(event) {
-    await this._channel.emit(event);
-  }
-};
-
 // src/agent/remote-room-data-source.ts
 var RemoteRoomDataSource = class {
   constructor(_serverUrl, _sessionToken, _roomId) {
@@ -1224,7 +1109,7 @@ ${conn.name} [${ref}] \u2014 ${mode}`);
     const selfId = this.getSelfIdForRoom(roomId);
     const disposition = this._engagement.classify(event, roomId, selfId, senderType, senderLookupId);
     if (disposition === "drop") return;
-    this._tracker.markDelivered(event.id);
+    if (!this._options.pullOnly) this._tracker.markDelivered(event.id);
     if (disposition === "content") {
       this._buffer.push(roomId, { event, roomId, roomName: labeled.roomName });
       return;
@@ -1752,12 +1637,126 @@ async function createStdioRuntimeMcpServer(opts) {
   return { stop, closed };
 }
 
+// src/agent/sse-multiplexer.ts
+var SseMultiplexer = class {
+  _queue = [];
+  _waiters = [];
+  _connections = /* @__PURE__ */ new Map();
+  _closed = false;
+  /**
+   * Add an SSE connection to a stoop server.
+   * Starts streaming events immediately.
+   */
+  addConnection(serverUrl, sessionToken, roomName, roomId) {
+    if (this._connections.has(roomId) || this._closed) return;
+    const abortController = new AbortController();
+    const loopPromise = this._sseLoop(serverUrl, sessionToken, roomName, roomId, abortController.signal);
+    this._connections.set(roomId, { serverUrl, sessionToken, roomName, roomId, abortController, loopPromise });
+  }
+  /** Remove a connection by room ID. */
+  removeConnection(roomId) {
+    const entry = this._connections.get(roomId);
+    if (!entry) return;
+    entry.abortController.abort();
+    this._connections.delete(roomId);
+  }
+  /** Close all connections and signal the iterator to finish. */
+  close() {
+    this._closed = true;
+    for (const [, entry] of this._connections) {
+      entry.abortController.abort();
+    }
+    this._connections.clear();
+    for (const waiter of this._waiters) {
+      waiter.resolve(null);
+    }
+    this._waiters = [];
+  }
+  async _sseLoop(serverUrl, sessionToken, roomName, roomId, signal) {
+    const INITIAL_BACKOFF = 1e3;
+    const MAX_BACKOFF = 3e4;
+    let backoff = INITIAL_BACKOFF;
+    while (!signal.aborted && !this._closed) {
+      try {
+        const res = await fetch(`${serverUrl}/events`, {
+          method: "POST",
+          headers: {
+            Accept: "text/event-stream",
+            Authorization: `Bearer ${sessionToken}`
+          },
+          signal
+        });
+        if (!res.ok || !res.body) {
+          throw new Error(`SSE connect failed: ${res.status}`);
+        }
+        backoff = INITIAL_BACKOFF;
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        while (!signal.aborted) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          buffer += decoder.decode(value, { stream: true });
+          const parts = buffer.split("\n\n");
+          buffer = parts.pop();
+          for (const part of parts) {
+            const dataLine = part.split("\n").find((l) => l.startsWith("data: "));
+            if (!dataLine) continue;
+            try {
+              const event = JSON.parse(dataLine.slice(6));
+              this._push({ roomId, roomName, event });
+            } catch {
+            }
+          }
+        }
+      } catch (err) {
+        if (signal.aborted) break;
+      }
+      if (!signal.aborted && !this._closed) {
+        await new Promise((r) => setTimeout(r, backoff));
+        backoff = Math.min(backoff * 2, MAX_BACKOFF);
+      }
+    }
+  }
+  _push(labeled) {
+    if (this._closed) return;
+    if (this._waiters.length > 0) {
+      const waiter = this._waiters.shift();
+      waiter.resolve(labeled);
+    } else {
+      this._queue.push(labeled);
+    }
+  }
+  [Symbol.asyncIterator]() {
+    return {
+      next: () => {
+        if (this._queue.length > 0) {
+          return Promise.resolve({ value: this._queue.shift(), done: false });
+        }
+        if (this._closed) {
+          return Promise.resolve({ value: void 0, done: true });
+        }
+        return new Promise((resolve) => {
+          this._waiters.push({
+            resolve: (value) => {
+              if (this._closed || value === null) {
+                resolve({ value: void 0, done: true });
+              } else {
+                resolve({ value, done: false });
+              }
+            }
+          });
+        });
+      }
+    };
+  }
+};
+
 export {
-  SseMultiplexer,
+  LocalRoomDataSource,
   parseEngagementMode,
   StoopsEngagement,
   classifyEvent,
-  LocalRoomDataSource,
   RemoteRoomDataSource,
   buildCatchUpLines,
   EventMultiplexer,
@@ -1766,6 +1765,7 @@ export {
   EventProcessor,
   RUNTIME_TOOL_NAMES,
   createRuntimeMcpServer,
-  createStdioRuntimeMcpServer
+  createStdioRuntimeMcpServer,
+  SseMultiplexer
 };
-//# sourceMappingURL=chunk-LN6ATWE3.js.map
+//# sourceMappingURL=chunk-WJD5EKO6.js.map