@vibesdotdev/chat 0.0.0-stage → 1.0.0-rc.1

package/dist/realtime/room.js

@@ -0,0 +1,58 @@
+import * as z from 'zod/v4';
+import { getLogger } from '@vibesdotdev/logging';
+import { CHAT_REALTIME_ROOM_CONTEXT_ID } from "./schemas/room.js";
+import { resolveChatContext } from "./resolve-context.js";
+// Re-export the constants + room-name helper so the DO binding owner (chat-web)
+// and any subscriber resolve the SAME id + binding name the cloud impl uses.
+export { CHAT_ROOM_BINDING, CHAT_REALTIME_ROOM_CONTEXT_ID, chatRealtimeRoomName } from "./schemas/room.js";
+const ChatRealtimeRoomMethodsSchema = z.object({
+    appendMessage: z.function(),
+    historySince: z.function(),
+    subscribe: z.function()
+});
+/** The `chat/realtime-room` context's owning schema: it admits the room itself, so its methods keep their receiver. */
+const ChatRealtimeRoomSchema = z.custom((value) => ChatRealtimeRoomMethodsSchema.safeParse(value).success);
+function logAbsent(runtime, op, roomId) {
+    getLogger('chat.realtime.room', runtime).debug('No realtime room context is composed in this scope', { op, roomId });
+}
+/**
+ * Upsert a rich message into the room's realtime history store. Without a
+ * composed realtime-room context (confirmed absence) it is a no-op, since D1
+ * stays authoritative in Phase 1; any other failure rejects typed.
+ */
+export async function appendRoomMessage(runtime, roomId, message) {
+    const { value: room } = await resolveChatContext(runtime, CHAT_REALTIME_ROOM_CONTEXT_ID, ChatRealtimeRoomSchema);
+    if (!room) {
+        logAbsent(runtime, 'appendMessage', roomId);
+        return;
+    }
+    await room.appendMessage(roomId, message);
+}
+/**
+ * Recent history for a room, ascending by createdAt. Empty only when no
+ * realtime-room context is composed (confirmed absence); any other failure
+ * rejects typed, never an empty history.
+ */
+export async function getRoomHistorySince(runtime, roomId, query) {
+    const { value: room } = await resolveChatContext(runtime, CHAT_REALTIME_ROOM_CONTEXT_ID, ChatRealtimeRoomSchema);
+    if (!room) {
+        logAbsent(runtime, 'historySince', roomId);
+        return [];
+    }
+    return room.historySince(roomId, query);
+}
+/**
+ * Subscribe to a room's live events. Returns an unsubscribe function (a no-op
+ * when no realtime-room context is composed); any other failure rejects typed.
+ * Dormant in Phase 1 surfaces; here so Phase 2 consumers can wire it without a
+ * second resolution path.
+ */
+export async function subscribeRoomEvents(runtime, roomId, onEvent) {
+    const { value: room } = await resolveChatContext(runtime, CHAT_REALTIME_ROOM_CONTEXT_ID, ChatRealtimeRoomSchema);
+    if (!room) {
+        logAbsent(runtime, 'subscribe', roomId);
+        return () => { };
+    }
+    return room.subscribe(roomId, onEvent);
+}
+//# sourceMappingURL=room.js.map

package/dist/realtime/room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.js","sourceRoot":"","sources":["../../src/realtime/room.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ1D,gFAAgF;AAChF,6EAA6E;AAC7E,OAAO,EACN,iBAAiB,EACjB,6BAA6B,EAC7B,oBAAoB,EACpB,MAAM,mBAAmB,CAAC;AAQ3B,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3B,YAAY,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvB,CAAC,CAAC;AACH,uHAAuH;AACvH,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAmB,CAAC,KAAK,EAAE,EAAE,CAAC,6BAA6B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;AAE7H,SAAS,SAAS,CAAC,OAAqB,EAAE,EAAU,EAAE,MAAc;IACnE,SAAS,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,oDAAoD,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACtH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,OAAqB,EACrB,MAAc,EACd,OAAwB;IAExB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,CAAC,CAAC;IACjH,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO;IACR,CAAC;IACD,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,OAAqB,EACrB,MAAc,EACd,KAA4B;IAE5B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,CAAC,CAAC;IACjH,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;QAC3C,OAAO,EAAE,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,OAAqB,EACrB,MAAc,EACd,OAA+C;IAE/C,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,CAAC,CAAC;IACjH,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/dist/realtime/schemas/publisher.d.ts

@@ -0,0 +1,137 @@
+import * as z from 'zod/v4';
+import type { SSEEvent } from '@vibesdotdev/realtime';
+import { type ValueFreeFailure } from '@vibesdotdev/kernel';
+/** One SSE payload value, exactly as realtime's public `SSEEvent.data` admits it. */
+export type ChatSSEValue = SSEEvent['data'];
+/** One SSE message body: a record of realtime SSE values. */
+export type ChatSSEData = Record<string, ChatSSEValue>;
+/** The deepest nesting a chat SSE value may carry; deeper values are not delivered. */
+export declare const CHAT_SSE_MAX_DEPTH = 32;
+/** One top-level entry `chatSSEDataFrom` could not deliver: its key, and the value-free failure when reading it threw. */
+export interface ChatSSEDroppedEntry {
+    readonly key: string;
+    readonly cause?: ValueFreeFailure;
+}
+/** What `chatSSEDataFrom` delivers, and the entries it could not (reported, never silent). */
+export interface ChatSSEDataReading {
+    readonly data: ChatSSEData;
+    readonly dropped: readonly ChatSSEDroppedEntry[];
+}
+/**
+ * Read a caller's event record into realtime's SSE payload type at the
+ * boundary. Each top-level entry parses independently: one entry that is not
+ * an SSE value (a function, a bigint, a cycle, a throwing getter) is dropped
+ * and named in `dropped`; it never fails the rest of the event.
+ */
+export declare function chatSSEDataFrom(record: Readonly<ChatSSEInputRecord>): ChatSSEDataReading;
+/** Untrusted event fields are admitted independently by ChatSSEValueSchema. */
+export declare const ChatSSEInputRecordSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type ChatSSEInputRecord = z.infer<typeof ChatSSEInputRecordSchema>;
+export type ChatSSEInput = ChatSSEInputRecord[string];
+export interface ChatEventPayload {
+    type: string;
+    chatRoomId: string;
+    messageId?: string;
+    userId?: string;
+    agentId?: string;
+    content?: string;
+    metadata?: Readonly<ChatSSEInputRecord>;
+}
+/** Owner-level invalidation for unified Inbox consumers. */
+export interface ChatInboxEventPayload {
+    ownerId: string;
+    chatRoomId: string;
+    messageId?: string;
+}
+export interface TypingEventPayload {
+    chatRoomId: string;
+    userId: string;
+    isTyping: boolean;
+}
+export interface PresenceEventPayload {
+    userId: string;
+    status: 'online' | 'offline' | 'away';
+    activeRooms: string[];
+    lastSeen?: string;
+}
+export declare const CHAT_REALTIME_PUBLISHER_CONTEXT_ID = "chat/realtime-publisher";
+/**
+ * Durable-Object binding name for the generic per-channel realtime fan-out
+ * relay (cloud cross-isolate push). Declared in chat-web's wrangler config.
+ */
+export declare const CHANNEL_RELAY_BINDING = "CHANNEL_RELAY";
+/** One ChannelRelay Durable Object stub, as the cloud publisher calls it. */
+export interface ChannelRelayStub {
+    fetch(input: string, init?: RequestInit): Promise<Response>;
+}
+/** One ChannelRelay Durable Object id: opaque, minted by `idFromName` and handed back to `get`. */
+export interface ChannelRelayObjectId {
+    toString(): string;
+}
+/** The `CHANNEL_RELAY` Durable Object namespace: a stub per channel id. */
+export interface ChannelRelayNamespace {
+    idFromName(name: string): ChannelRelayObjectId;
+    get(id: ChannelRelayObjectId): ChannelRelayStub;
+}
+/**
+ * CHANNEL_RELAY's owning schema for `runtime.getBinding`. It admits the
+ * namespace itself, never a copy, so its methods keep their receiver.
+ */
+export declare const ChannelRelayNamespaceSchema: z.ZodCustom<ChannelRelayNamespace, ChannelRelayNamespace>;
+/**
+ * The realtime channel id for a chat room's message stream. The cloud publisher
+ * routes a room's events to `idFromName(chatRealtimeChannelId(roomId))` on the
+ * ChannelRelay DO, and the SSE endpoint subscribes to the same id. Keep this the
+ * single source of truth so the two sides never drift. Domain-agnostic siblings
+ * (e.g. `code-session:<id>`) reuse the same DO with a different prefix.
+ */
+export declare function chatRealtimeChannelId(roomId: string): string;
+/** One durable relay channel per owner, independent of room count. */
+export declare function chatInboxRealtimeChannelId(ownerId: string): string;
+/**
+ * A turn-scoped high-frequency realtime stream.
+ *
+ * The cloud implementation holds ONE WebSocket to the channel's relay DO —
+ * frames sent after the upgrade are NOT subrequests, so a long streaming turn
+ * can push every delta without rationing against the worker's ~1000-subrequest
+ * budget (the constraint that forced the old 200ms→1s→4s snapshot backoff).
+ * Local/consumer implementations broadcast in-process.
+ */
+export interface ChatRealtimeTurnStream {
+    /**
+     * True while the transport delivers instantly (publisher socket open, or an
+     * in-process bus). Callers MUST route through their slow-path publish when
+     * this is false — send() on a non-live stream is a silent no-op.
+     */
+    isLive(): boolean;
+    /** Fire-and-forget one event envelope to the channel's subscribers. */
+    send(type: string, data: Readonly<ChatSSEInputRecord>): void;
+    /** Release the transport (closes the publisher socket on cloud). */
+    close(): void;
+    /**
+     * Which transport this stream actually bound: 'do-websocket' (cloud relay
+     * socket), 'do-unavailable' (cloud impl resolved but no socket), 'in-process'
+     * (consumer bus), 'none' (resolution failed). Callers persist this into turn
+     * metadata so a silent delivery failure is diagnosable from the stored row —
+     * tail logging proved too lossy to answer "which impl ran?" in production.
+     */
+    readonly transport: string;
+}
+/**
+ * The `chat/realtime-publisher` context's owning schema. It admits the
+ * publisher itself, never a copy, so its methods keep their receiver.
+ */
+export declare const ChatRealtimePublisherSchema: z.ZodCustom<ChatRealtimePublisher, ChatRealtimePublisher>;
+export interface ChatRealtimePublisher {
+    publishChatEvent(payload: ChatEventPayload): Promise<void>;
+    publishChatInboxEvent?(payload: ChatInboxEventPayload): Promise<void>;
+    publishTypingEvent(payload: TypingEventPayload): Promise<void>;
+    publishPresenceEvent(payload: PresenceEventPayload): Promise<void>;
+    /**
+     * Open a turn-scoped stream for high-frequency events (streaming deltas,
+     * tool cards). Optional — callers fall back to publishChatEvent when the
+     * method is absent or the returned stream never goes live.
+     */
+    openTurnStream?(channelId: string): Promise<ChatRealtimeTurnStream>;
+}
+//# sourceMappingURL=publisher.d.ts.map

package/dist/realtime/schemas/publisher.d.ts.map

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

package/dist/realtime/schemas/publisher.js

@@ -0,0 +1,88 @@
+import * as z from 'zod/v4';
+import { CaughtFailureSchema, settleNow, valueFreeFailure } from '@vibesdotdev/kernel';
+import { parseChatUntrusted } from "../../utils/parse-guard.js";
+/** The deepest nesting a chat SSE value may carry; deeper values are not delivered. */
+export const CHAT_SSE_MAX_DEPTH = 32;
+function sseValueSchema(depth) {
+    const leaf = z.union([z.string(), z.number(), z.boolean(), z.null(), z.undefined()]);
+    if (depth >= CHAT_SSE_MAX_DEPTH)
+        return leaf;
+    return z.lazy(() => z.union([leaf, z.array(sseValueSchema(depth + 1)), z.record(z.string(), sseValueSchema(depth + 1))]));
+}
+const ChatSSEValueSchema = sseValueSchema(0);
+/**
+ * Read a caller's event record into realtime's SSE payload type at the
+ * boundary. Each top-level entry parses independently: one entry that is not
+ * an SSE value (a function, a bigint, a cycle, a throwing getter) is dropped
+ * and named in `dropped`; it never fails the rest of the event.
+ */
+export function chatSSEDataFrom(record) {
+    const data = {};
+    const dropped = [];
+    let keys;
+    try {
+        keys = Object.keys(record);
+    }
+    catch (error) {
+        // A hostile record (revoked Proxy) yields no entries; the record itself is reported.
+        return { data, dropped: [{ key: '(record)', cause: valueFreeFailure(CaughtFailureSchema.parse(error)) }] };
+    }
+    for (const key of keys) {
+        const reading = settleNow(() => record[key]);
+        if (!reading.ok) {
+            dropped.push({ key, cause: valueFreeFailure(reading.cause) });
+            continue;
+        }
+        const value = reading.value;
+        const parsed = parseChatUntrusted(ChatSSEValueSchema, value);
+        if (parsed.outcome === 'parsed') {
+            // defineProperty keeps a key named `__proto__` an own data key.
+            Object.defineProperty(data, key, { value: parsed.data, enumerable: true, writable: true, configurable: true });
+        }
+        else {
+            dropped.push({ key });
+        }
+    }
+    return { data, dropped };
+}
+/** Untrusted event fields are admitted independently by ChatSSEValueSchema. */
+export const ChatSSEInputRecordSchema = z.record(z.string(), z.unknown());
+export const CHAT_REALTIME_PUBLISHER_CONTEXT_ID = 'chat/realtime-publisher';
+/**
+ * Durable-Object binding name for the generic per-channel realtime fan-out
+ * relay (cloud cross-isolate push). Declared in chat-web's wrangler config.
+ */
+export const CHANNEL_RELAY_BINDING = 'CHANNEL_RELAY';
+const ChannelRelayNamespaceMethodsSchema = z.object({ idFromName: z.function(), get: z.function() });
+/**
+ * CHANNEL_RELAY's owning schema for `runtime.getBinding`. It admits the
+ * namespace itself, never a copy, so its methods keep their receiver.
+ */
+export const ChannelRelayNamespaceSchema = z.custom((value) => ChannelRelayNamespaceMethodsSchema.safeParse(value).success);
+/**
+ * The realtime channel id for a chat room's message stream. The cloud publisher
+ * routes a room's events to `idFromName(chatRealtimeChannelId(roomId))` on the
+ * ChannelRelay DO, and the SSE endpoint subscribes to the same id. Keep this the
+ * single source of truth so the two sides never drift. Domain-agnostic siblings
+ * (e.g. `code-session:<id>`) reuse the same DO with a different prefix.
+ */
+export function chatRealtimeChannelId(roomId) {
+    return `chat:${roomId}`;
+}
+/** One durable relay channel per owner, independent of room count. */
+export function chatInboxRealtimeChannelId(ownerId) {
+    return `chat:inbox:${ownerId}`;
+}
+const ChatRealtimePublisherMethodsSchema = z.object({
+    publishChatEvent: z.function(),
+    publishTypingEvent: z.function(),
+    publishPresenceEvent: z.function(),
+    publishChatInboxEvent: z.function().optional(),
+    openTurnStream: z.function().optional()
+});
+/**
+ * The `chat/realtime-publisher` context's owning schema. It admits the
+ * publisher itself, never a copy, so its methods keep their receiver.
+ */
+export const ChatRealtimePublisherSchema = z.custom((value) => ChatRealtimePublisherMethodsSchema.safeParse(value).success);
+//# sourceMappingURL=publisher.js.map

package/dist/realtime/schemas/publisher.js.map

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

package/dist/realtime/schemas/room.d.ts

@@ -0,0 +1,125 @@
+/**
+ * chat/realtime-room — schemas + constants (single source of truth).
+ *
+ * This is the READ+STORE sibling of `chat/realtime-publisher` (the write/fan-out
+ * side). Where the publisher carries a LEAN event envelope, this context owns the
+ * RICH canonical message shape — the same fields as the D1 `chatMessages` table
+ * and the SSE `ReplayMessage` projection — so recent history can live next to live
+ * push in ONE per-room Durable Object (SQLite + hibernatable WebSocket).
+ *
+ * Phase 1 (additive shadow): the cloud impl appends the rich row to the per-room
+ * DO behind a flag while D1 stays authoritative and reads/transport are unchanged.
+ * Phases 2–3 retire the D1 poll, cut reads/subscribe over to this DO, and demote
+ * D1 to an async-mirrored archive. The interface below is transport-neutral on
+ * purpose so every surface (chat-web SSE today; TUI/bridge/marshal/casework later)
+ * consumes it identically.
+ */
+import * as z from 'zod/v4';
+/** Runtime context id. Consumers `runtime.query('context').withId(...)`. */
+export declare const CHAT_REALTIME_ROOM_CONTEXT_ID = "chat/realtime-room";
+/**
+ * Durable-Object binding name for the per-room history + live-push DO. Declared
+ * in chat-web's deployment.config.ts (`durableObjects`) and reached ONLY via
+ * `runtime.getBinding(CHAT_ROOM_BINDING, ChatRoomNamespaceSchema)` from cloud server code — never a public
+ * route. Single shared constant imported by both the binding declaration and the
+ * cloud impl so the two sides never drift.
+ */
+export declare const CHAT_ROOM_BINDING = "CHAT_ROOM";
+/** One per-room Durable Object stub, as the cloud room context calls it. */
+export interface ChatRoomStub {
+    fetch(input: string | Request, init?: RequestInit): Promise<Response>;
+}
+/** One per-room Durable Object id: opaque, minted by `idFromName` and handed back to `get`. */
+export interface ChatRoomObjectId {
+    toString(): string;
+}
+/** The `CHAT_ROOM` Durable Object namespace: a stub per room name. */
+export interface ChatRoomNamespace {
+    idFromName(name: string): ChatRoomObjectId;
+    get(id: ChatRoomObjectId): ChatRoomStub;
+}
+/**
+ * CHAT_ROOM's owning schema for `runtime.getBinding`. It admits the namespace
+ * itself, never a copy, so its methods keep their receiver.
+ */
+export declare const ChatRoomNamespaceSchema: z.ZodCustom<ChatRoomNamespace, ChatRoomNamespace>;
+/**
+ * The DO instance name for a room (`idFromName`). CHAT_ROOM is its own binding
+ * namespace, so the bare roomId is unambiguous (no `chat:` prefix needed, unlike
+ * the shared ChannelRelay channel id). Kept as a function so the name convention
+ * has a single home.
+ */
+export declare function chatRealtimeRoomName(roomId: string): string;
+/**
+ * The rich canonical room-message shape. MUST stay field-compatible with the D1
+ * `chatMessages` table (apps/chat-web/src/server/db/tables/messages.ts) and the
+ * SSE `ReplayMessage` projection (apps/chat-web/src/lib/server/queries/schemas).
+ * This is the reconciled single source of truth — NOT the orphan worker's
+ * simplistic role/sender_id/content shape.
+ *
+ * `createdAt` is epoch milliseconds (D1 stores `timestamp_ms`; the DO stores the
+ * same integer) so parity comparisons and reconnect replay never drift on
+ * precision.
+ */
+/** One rich room message read from an untrusted source (the room DO's JSON), parsed per item. */
+export declare const ChatRoomMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    chatRoomId: z.ZodString;
+    status: z.ZodNullable<z.ZodString>;
+    userId: z.ZodNullable<z.ZodString>;
+    agentId: z.ZodNullable<z.ZodString>;
+    replyToId: z.ZodNullable<z.ZodString>;
+    messageType: z.ZodString;
+    senderType: z.ZodEnum<{
+        agent: "agent";
+        user: "user";
+        system: "system";
+    }>;
+    content: z.ZodNullable<z.ZodString>;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    createdAt: z.ZodNumber;
+}, z.core.$strip>;
+export type ChatRoomMessage = z.infer<typeof ChatRoomMessageSchema>;
+/** One live room frame (`{type, data}`) from the room DO's socket. */
+export declare const ChatRoomRealtimeFrameSchema: z.ZodObject<{
+    type: z.ZodString;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>;
+}, z.core.$strip>;
+export interface ChatRoomHistoryQuery {
+    /** Epoch ms lower bound (inclusive). Omitted = from the beginning of recent history. */
+    since?: number;
+    /** Max rows (server caps at a hard ceiling). */
+    limit?: number;
+}
+/** A live realtime event broadcast by the room DO ({type,data} envelope). */
+export declare const ChatRoomRealtimeEventSchema: z.ZodObject<{
+    type: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>;
+}, z.core.$strip>;
+export type ChatRoomRealtimeEvent = z.infer<typeof ChatRoomRealtimeEventSchema>;
+/**
+ * Transport-neutral per-room realtime capability. Resolved via the runtime so
+ * cloud (DO-backed) and consumer (HTTP/SSE-backed) surfaces are interchangeable.
+ */
+export interface ChatRealtimeRoom {
+    /**
+     * Upsert the rich message into the room's recent-history store. Idempotent on
+     * `id` (streaming rows grow in place), so calling repeatedly as content/status
+     * evolve converges the store to the latest state. Best-effort: never throws.
+     *
+     * The CLOUD impl honors this fully (DO upsert). The CONSUMER/off-cloud impl
+     * defers the rich write to Phase 2 and is a documented no-op in Phase 1 — there
+     * is no off-cloud endpoint that preserves the full ChatRoomMessage, and exposing
+     * a lossy `sendMessage`-based write would silently diverge from this contract.
+     */
+    appendMessage(roomId: string, message: ChatRoomMessage): Promise<void>;
+    /** Recent history for a room, ascending by createdAt. */
+    historySince(roomId: string, query?: ChatRoomHistoryQuery): Promise<ChatRoomMessage[]>;
+    /**
+     * Subscribe to the room's live event stream. Returns an unsubscribe function.
+     * Dormant in Phase 1 (reads still flow through the D1 poll + ChannelRelay);
+     * wired into surfaces in Phase 2.
+     */
+    subscribe(roomId: string, onEvent: (event: ChatRoomRealtimeEvent) => void): Promise<() => void>;
+}
+//# sourceMappingURL=room.d.ts.map

package/dist/realtime/schemas/room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../../../src/realtime/schemas/room.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,4EAA4E;AAC5E,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACtE;AAED,+FAA+F;AAC/F,MAAM,WAAW,gBAAgB;IAChC,QAAQ,IAAI,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IACjC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAC3C,GAAG,CAAC,EAAE,EAAE,gBAAgB,GAAG,YAAY,CAAC;CACxC;AAID;;;GAGG;AACH,eAAO,MAAM,uBAAuB,mDAEnC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;;;;GAUG;AACH,iGAAiG;AACjG,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;iBAYhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,sEAAsE;AACtE,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AAEH,MAAM,WAAW,oBAAoB;IACpC,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,6EAA6E;AAC7E,eAAO,MAAM,2BAA2B;;;iBAAsF,CAAC;AAC/H,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC;;;;;;;;;OASG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,yDAAyD;IACzD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACvF;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;CAChG"}

package/dist/realtime/schemas/room.js

@@ -0,0 +1,76 @@
+/**
+ * chat/realtime-room — schemas + constants (single source of truth).
+ *
+ * This is the READ+STORE sibling of `chat/realtime-publisher` (the write/fan-out
+ * side). Where the publisher carries a LEAN event envelope, this context owns the
+ * RICH canonical message shape — the same fields as the D1 `chatMessages` table
+ * and the SSE `ReplayMessage` projection — so recent history can live next to live
+ * push in ONE per-room Durable Object (SQLite + hibernatable WebSocket).
+ *
+ * Phase 1 (additive shadow): the cloud impl appends the rich row to the per-room
+ * DO behind a flag while D1 stays authoritative and reads/transport are unchanged.
+ * Phases 2–3 retire the D1 poll, cut reads/subscribe over to this DO, and demote
+ * D1 to an async-mirrored archive. The interface below is transport-neutral on
+ * purpose so every surface (chat-web SSE today; TUI/bridge/marshal/casework later)
+ * consumes it identically.
+ */
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import * as z from 'zod/v4';
+/** Runtime context id. Consumers `runtime.query('context').withId(...)`. */
+export const CHAT_REALTIME_ROOM_CONTEXT_ID = 'chat/realtime-room';
+/**
+ * Durable-Object binding name for the per-room history + live-push DO. Declared
+ * in chat-web's deployment.config.ts (`durableObjects`) and reached ONLY via
+ * `runtime.getBinding(CHAT_ROOM_BINDING, ChatRoomNamespaceSchema)` from cloud server code — never a public
+ * route. Single shared constant imported by both the binding declaration and the
+ * cloud impl so the two sides never drift.
+ */
+export const CHAT_ROOM_BINDING = 'CHAT_ROOM';
+const ChatRoomNamespaceMethodsSchema = z.object({ idFromName: z.function(), get: z.function() });
+/**
+ * CHAT_ROOM's owning schema for `runtime.getBinding`. It admits the namespace
+ * itself, never a copy, so its methods keep their receiver.
+ */
+export const ChatRoomNamespaceSchema = z.custom((value) => ChatRoomNamespaceMethodsSchema.safeParse(value).success);
+/**
+ * The DO instance name for a room (`idFromName`). CHAT_ROOM is its own binding
+ * namespace, so the bare roomId is unambiguous (no `chat:` prefix needed, unlike
+ * the shared ChannelRelay channel id). Kept as a function so the name convention
+ * has a single home.
+ */
+export function chatRealtimeRoomName(roomId) {
+    return roomId;
+}
+/**
+ * The rich canonical room-message shape. MUST stay field-compatible with the D1
+ * `chatMessages` table (apps/chat-web/src/server/db/tables/messages.ts) and the
+ * SSE `ReplayMessage` projection (apps/chat-web/src/lib/server/queries/schemas).
+ * This is the reconciled single source of truth — NOT the orphan worker's
+ * simplistic role/sender_id/content shape.
+ *
+ * `createdAt` is epoch milliseconds (D1 stores `timestamp_ms`; the DO stores the
+ * same integer) so parity comparisons and reconnect replay never drift on
+ * precision.
+ */
+/** One rich room message read from an untrusted source (the room DO's JSON), parsed per item. */
+export const ChatRoomMessageSchema = z.object({
+    id: z.string().min(1),
+    chatRoomId: z.string().min(1),
+    status: z.string().nullable(),
+    userId: z.string().nullable(),
+    agentId: z.string().nullable(),
+    replyToId: z.string().nullable(),
+    messageType: z.string(),
+    senderType: z.enum(['user', 'agent', 'system']),
+    content: z.string().nullable(),
+    metadata: z.record(z.string(), z.unknown()).nullable(),
+    createdAt: z.number().finite()
+});
+/** One live room frame (`{type, data}`) from the room DO's socket. */
+export const ChatRoomRealtimeFrameSchema = z.object({
+    type: z.string().min(1),
+    data: z.record(z.string(), JsonValueSchema).optional()
+});
+/** A live realtime event broadcast by the room DO ({type,data} envelope). */
+export const ChatRoomRealtimeEventSchema = ChatRoomRealtimeFrameSchema.extend({ data: z.record(z.string(), JsonValueSchema) });
+//# sourceMappingURL=room.js.map

package/dist/realtime/schemas/room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.js","sourceRoot":"","sources":["../../../src/realtime/schemas/room.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,4EAA4E;AAC5E,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC;AAElE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAkB7C,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAEjG;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAC9C,CAAC,KAAK,EAAE,EAAE,CAAC,8BAA8B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAClE,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IAClD,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,iGAAiG;AACjG,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;CAC9B,CAAC,CAAC;AAGH,sEAAsE;AACtE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AASH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,2BAA2B,GAAG,2BAA2B,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC"}

package/dist/realtime/sse-data.d.ts

@@ -0,0 +1,10 @@
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import { type ChatEventPayload, type ChatSSEData, type ChatSSEInput } from './schemas/publisher.ts';
+/**
+ * Read a caller's record into realtime's SSE payload type. Entries that are
+ * not SSE values are dropped and reported once on the handed runtime, by key.
+ */
+export declare function chatSSEData(runtime: RuntimeRef, record: Readonly<Record<string, ChatSSEInput>>, what: string): ChatSSEData;
+/** The SSE body of one chat event, with its metadata read through the SSE boundary. */
+export declare function chatEventSSEData(runtime: RuntimeRef, payload: ChatEventPayload): ChatSSEData;
+//# sourceMappingURL=sse-data.d.ts.map

package/dist/realtime/sse-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-data.d.ts","sourceRoot":"","sources":["../../src/realtime/sse-data.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAEN,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,MAAM,wBAAwB,CAAC;AAEhC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAS1H;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAU5F"}

package/dist/realtime/sse-data.js

@@ -0,0 +1,29 @@
+import { getLogger } from '@vibesdotdev/logging';
+import { chatSSEDataFrom } from "./schemas/publisher.js";
+/**
+ * Read a caller's record into realtime's SSE payload type. Entries that are
+ * not SSE values are dropped and reported once on the handed runtime, by key.
+ */
+export function chatSSEData(runtime, record, what) {
+    const reading = chatSSEDataFrom(record);
+    if (reading.dropped.length > 0) {
+        getLogger('chat.realtime.sse-data', runtime).warn('Chat realtime fields are not SSE values and were not delivered', {
+            what,
+            dropped: reading.dropped.map((entry) => ({ field: entry.key, failure: entry.cause?.name }))
+        });
+    }
+    return reading.data;
+}
+/** The SSE body of one chat event, with its metadata read through the SSE boundary. */
+export function chatEventSSEData(runtime, payload) {
+    return {
+        type: payload.type,
+        chatRoomId: payload.chatRoomId,
+        messageId: payload.messageId,
+        userId: payload.userId,
+        agentId: payload.agentId,
+        content: payload.content,
+        metadata: payload.metadata ? chatSSEData(runtime, payload.metadata, 'chat event metadata') : undefined
+    };
+}
+//# sourceMappingURL=sse-data.js.map

package/dist/realtime/sse-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-data.js","sourceRoot":"","sources":["../../src/realtime/sse-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EACN,eAAe,EAIf,MAAM,wBAAwB,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAmB,EAAE,MAA8C,EAAE,IAAY;IAC5G,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,SAAS,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,gEAAgE,EAAE;YACnH,IAAI;YACJ,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;SAC3F,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,gBAAgB,CAAC,OAAmB,EAAE,OAAyB;IAC9E,OAAO;QACN,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,SAAS;KACtG,CAAC;AACH,CAAC"}

package/dist/realtime/sse-hub-helper.d.ts

@@ -0,0 +1,9 @@
+import type { SSEService } from '@vibesdotdev/realtime';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+/**
+ * Resolve the SSE hub from the runtime, returning null gracefully when the
+ * realtime/sse-hub context is unavailable so in-isolate broadcast remains
+ * best-effort.
+ */
+export declare function getSseHubOrNull(runtime: VibesRuntime): Promise<SSEService | null>;
+//# sourceMappingURL=sse-hub-helper.d.ts.map

package/dist/realtime/sse-hub-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-hub-helper.d.ts","sourceRoot":"","sources":["../../src/realtime/sse-hub-helper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAKvF"}

package/dist/realtime/sse-hub-helper.js

@@ -0,0 +1,13 @@
+import { getRealtimeSseHub, REALTIME_SSE_HUB_CONTEXT_ID } from '@vibesdotdev/realtime';
+/**
+ * Resolve the SSE hub from the runtime, returning null gracefully when the
+ * realtime/sse-hub context is unavailable so in-isolate broadcast remains
+ * best-effort.
+ */
+export async function getSseHubOrNull(runtime) {
+    if (!runtime.hasContext(REALTIME_SSE_HUB_CONTEXT_ID)) {
+        return null;
+    }
+    return await getRealtimeSseHub(runtime);
+}
+//# sourceMappingURL=sse-hub-helper.js.map

package/dist/realtime/sse-hub-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-hub-helper.js","sourceRoot":"","sources":["../../src/realtime/sse-hub-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAIvF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAqB;IAC1D,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,2BAA2B,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/realtime-transport/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Real-Time Substrate
+ *
+ * Server-Sent Events (SSE) and WebSocket adapters for real-time communication.
+ */
+export { SSEService } from './sse-service.ts';
+export type { SSEEvent, SSEStreamOptions, SSEController, SSEConnection, SSEStats } from './sse-service.ts';
+export { WebSocketAdapter, WsClientMessageSchema, WS_AUTH_REFUSED_MESSAGE, WS_MAX_CHANNEL_LENGTH } from './ws-adapter.ts';
+export type { WsSocketLike, WsServerLike, WsClientMessage, WsServerMessage, WsConnection, WsStats, WsMessageHandler, WsConnectHandler, WsDisconnectHandler, WsJsonValue, WsAuthIdentity, WsAuthValidator, WsUpgradeRequest, WebSocketAdapterOptions } from './ws-adapter.ts';
+export { WsLocalBridge } from './ws-local-bridge.ts';
+export type { WsLocalBridgeOptions } from './ws-local-bridge.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/realtime-transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime-transport/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACX,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,QAAQ,EACR,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC1H,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/realtime-transport/index.js

@@ -0,0 +1,12 @@
+/**
+ * Real-Time Substrate
+ *
+ * Server-Sent Events (SSE) and WebSocket adapters for real-time communication.
+ */
+// SSE
+export { SSEService } from "./sse-service.js";
+// WebSocket
+export { WebSocketAdapter, WsClientMessageSchema, WS_AUTH_REFUSED_MESSAGE, WS_MAX_CHANNEL_LENGTH } from "./ws-adapter.js";
+// Local bridge. Provider bridges belong to Integrations.
+export { WsLocalBridge } from "./ws-local-bridge.js";
+//# sourceMappingURL=index.js.map

package/dist/realtime-transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/realtime-transport/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM;AACN,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAS9C,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAkB1H,yDAAyD;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}