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

package/dist/realtime/chat.realtime.room.context.impl.cloud.js

@@ -0,0 +1,161 @@
+import { settleNow, valueFreeFailure } from '@vibesdotdev/kernel';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import * as z from 'zod/v4';
+import { CapabilityError, createRuntimeImplementation } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import { CHAT_REALTIME_ROOM_CONTEXT_ID, CHAT_ROOM_BINDING, ChatRoomMessageSchema, ChatRoomNamespaceSchema, ChatRoomRealtimeFrameSchema, chatRealtimeRoomName } from "./schemas/room.js";
+import { parseChatUntrusted } from "../utils/parse-guard.js";
+/**
+ * Cloud chat realtime-room context.
+ *
+ * Owns recent per-room history + live push via ONE per-room Durable Object
+ * (`CHAT_ROOM`): rich-shape SQLite store AND hibernatable-WebSocket transport.
+ * Reached via `runtime.getBinding(CHAT_ROOM_BINDING, ChatRoomNamespaceSchema)` — NOT `runtime.resolve()`
+ * (DO namespaces are wrangler env bindings, not runtime-registered assets), and
+ * NEVER a public route (this DO is internal-only, like ChannelRelay).
+ *
+ * When the binding is absent (local dev, or before the migration applies) every
+ * method is a no-op / empty result: D1 stays authoritative in Phase 1. With the
+ * binding present, `appendMessage` stays best-effort (the interface's
+ * never-throws upsert; a failure is logged), while a failed or malformed
+ * history read rejects typed: an answer from a present store is never absence.
+ */
+const LOGGER_ID = 'chat.realtime.room.cloud';
+/** The room DO's history answer; each message parses on its own. */
+const HistoryBodySchema = z.object({ messages: z.array(JsonValueSchema) });
+const RoomSubscriberSocketMethodsSchema = z.object({ accept: z.function(), close: z.function(), addEventListener: z.function() });
+/** Admits the socket itself (never a copy), so its methods keep their receiver. */
+const RoomSubscriberSocketSchema = z.custom((value) => RoomSubscriberSocketMethodsSchema.safeParse(value).success);
+const RoomUpgradeResponseSchema = z.object({ webSocket: RoomSubscriberSocketSchema });
+function roomStub(runtime, roomId) {
+    const ns = runtime.getBinding(CHAT_ROOM_BINDING, ChatRoomNamespaceSchema);
+    if (!ns) {
+        // No DO binding in this environment — D1 is authoritative and covers reads.
+        return null;
+    }
+    return ns.get(ns.idFromName(chatRealtimeRoomName(roomId)));
+}
+async function appendMessage(runtime, roomId, message) {
+    const logger = getLogger(LOGGER_ID, runtime);
+    const stub = roomStub(runtime, roomId);
+    if (!stub)
+        return;
+    try {
+        const response = await stub.fetch('https://chat-room.internal/messages', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(message)
+        });
+        if (!response.ok)
+            logger.warn('realtime room appendMessage was refused', { roomId, status: response.status });
+    }
+    catch (error) {
+        // Best-effort: D1 is authoritative; a dropped mirror write self-heals on the
+        // next publish for the same id (appendMessage is an idempotent upsert).
+        logger.warn('realtime room appendMessage degraded', { error, roomId });
+    }
+}
+async function historySince(runtime, roomId, query = {}) {
+    const stub = roomStub(runtime, roomId);
+    if (!stub)
+        return [];
+    const url = new URL('https://chat-room.internal/messages');
+    if (query.since != null)
+        url.searchParams.set('since', String(query.since));
+    if (query.limit != null)
+        url.searchParams.set('limit', String(query.limit));
+    const response = await stub.fetch(url.toString());
+    if (!response.ok) {
+        throw new CapabilityError('The realtime room history read was refused.', 'UNAVAILABLE', {
+            reason: 'chat-realtime-room-history-refused',
+            details: { status: response.status }
+        });
+    }
+    let body;
+    try {
+        body = HistoryBodySchema.parse(await response.json());
+    }
+    catch (error) {
+        throw new CapabilityError('The realtime room history answer is malformed.', 'UNAVAILABLE', {
+            reason: 'chat-realtime-room-history-malformed',
+            cause: error
+        });
+    }
+    const messages = [];
+    let skipped = 0;
+    for (const item of body.messages) {
+        const message = parseChatUntrusted(ChatRoomMessageSchema, item);
+        if (message.outcome === 'parsed')
+            messages.push(message.data);
+        else
+            skipped += 1;
+    }
+    if (skipped > 0) {
+        getLogger(LOGGER_ID, runtime).warn('realtime room history skipped malformed messages', { roomId, skipped });
+    }
+    return messages;
+}
+async function subscribe(runtime, roomId, onEvent) {
+    const logger = getLogger(LOGGER_ID, runtime);
+    const stub = roomStub(runtime, roomId);
+    if (!stub)
+        return () => { };
+    let socket = null;
+    try {
+        const response = await stub.fetch(new Request('https://chat-room.internal/subscribe', {
+            headers: { Upgrade: 'websocket' }
+        }));
+        const upgrade = parseChatUntrusted(RoomUpgradeResponseSchema, response);
+        if (upgrade.outcome !== 'parsed') {
+            logger.warn('realtime room subscribe was not upgraded', { roomId, status: response.status });
+            return () => { };
+        }
+        const ws = upgrade.data.webSocket;
+        ws.accept();
+        socket = ws;
+        ws.addEventListener('message', (event) => {
+            const text = z.string().min(1).safeParse(event.data);
+            if (!text.success)
+                return;
+            const decoded = settleNow(() => JsonValueSchema.parse(JSON.parse(text.data)));
+            if (!decoded.ok) {
+                logger.warn('realtime room frame is not JSON', { failure: valueFreeFailure(decoded.cause), roomId });
+                return;
+            }
+            const json = decoded.value;
+            const frame = parseChatUntrusted(ChatRoomRealtimeFrameSchema, json);
+            if (frame.outcome !== 'parsed') {
+                logger.warn('realtime room frame is malformed', { roomId, paths: frame.outcome === 'invalid' ? frame.paths : [] });
+                return;
+            }
+            onEvent({ type: frame.data.type, data: frame.data.data ?? {} });
+        });
+    }
+    catch (error) {
+        throw new CapabilityError('Chat realtime subscription failed.', 'UNAVAILABLE', { reason: 'chat-realtime-subscribe-failed', cause: error });
+    }
+    return () => {
+        try {
+            socket?.close();
+        }
+        catch (error) {
+            throw new CapabilityError('Chat realtime subscription could not close.', 'UNAVAILABLE', { reason: 'chat-realtime-close-failed', cause: error });
+        }
+    };
+}
+function createCloudChatRealtimeRoom(runtime) {
+    return {
+        appendMessage: (roomId, message) => appendMessage(runtime, roomId, message),
+        historySince: (roomId, query) => historySince(runtime, roomId, query),
+        subscribe: (roomId, onEvent) => subscribe(runtime, roomId, onEvent)
+    };
+}
+export default createRuntimeImplementation({
+    kind: 'context',
+    id: CHAT_REALTIME_ROOM_CONTEXT_ID,
+    constraint: { hardware: ['cloud'] },
+    implementation: {
+        provide: (runtime) => createCloudChatRealtimeRoom(runtime)
+    }
+});
+//# sourceMappingURL=chat.realtime.room.context.impl.cloud.js.map

package/dist/realtime/chat.realtime.room.context.impl.cloud.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.realtime.room.context.impl.cloud.js","sourceRoot":"","sources":["../../src/realtime/chat.realtime.room.context.impl.cloud.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAqB,MAAM,qBAAqB,CAAC;AACtG,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACN,6BAA6B,EAC7B,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,oBAAoB,EACpB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AAEH,MAAM,SAAS,GAAG,0BAA0B,CAAC;AAE7C,oEAAoE;AACpE,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;AAQ3E,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAClI,mFAAmF;AACnF,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAC1C,CAAC,KAAK,EAAE,EAAE,CAAC,iCAAiC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CACrE,CAAC;AACF,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,0BAA0B,EAAE,CAAC,CAAC;AAEtF,SAAS,QAAQ,CAAC,OAAqB,EAAE,MAAc;IACtD,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;IAC1E,IAAI,CAAC,EAAE,EAAE,CAAC;QACT,4EAA4E;QAC5E,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,KAAK,UAAU,aAAa,CAC3B,OAAqB,EACrB,MAAc,EACd,OAAwB;IAExB,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO;IAClB,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,qCAAqC,EAAE;YACxE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/G,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,6EAA6E;QAC7E,wEAAwE;QACxE,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;AACF,CAAC;AAED,KAAK,UAAU,YAAY,CAC1B,OAAqB,EACrB,MAAc,EACd,QAA8B,EAAE;IAEhC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,qCAAqC,CAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5E,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,eAAe,CAAC,6CAA6C,EAAE,aAAa,EAAE;YACvF,MAAM,EAAE,oCAAoC;YAC5C,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;SACpC,CAAC,CAAC;IACJ,CAAC;IACD,IAAI,IAAuC,CAAC;IAC5C,IAAI,CAAC;QACJ,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,eAAe,CAAC,gDAAgD,EAAE,aAAa,EAAE;YAC1F,MAAM,EAAE,sCAAsC;YAC9C,KAAK,EAAE,KAAK;SACZ,CAAC,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,kBAAkB,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;QAChE,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;;YACzD,OAAO,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QACjB,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,kDAAkD,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7G,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,SAAS,CACvB,OAAqB,EACrB,MAAc,EACd,OAA+C;IAE/C,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAC3B,IAAI,MAAM,GAAgC,IAAI,CAAC;IAC/C,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAChC,IAAI,OAAO,CAAC,sCAAsC,EAAE;YACnD,OAAO,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE;SACjC,CAAC,CACF,CAAC;QACF,MAAM,OAAO,GAAG,kBAAkB,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAC;QACxE,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7F,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QACjB,CAAC;QACD,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QAClC,EAAE,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,EAAE,CAAC;QACZ,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YACxC,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAC1B,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9E,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;gBACrG,OAAO;YACR,CAAC;YACD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;YAC3B,MAAM,KAAK,GAAG,kBAAkB,CAAC,2BAA2B,EAAE,IAAI,CAAC,CAAC;YACpE,IAAI,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnH,OAAO;YACR,CAAC;YACD,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,eAAe,CAAC,oCAAoC,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,gCAAgC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5I,CAAC;IACD,OAAO,GAAG,EAAE;QACX,IAAI,CAAC;YACJ,MAAM,EAAE,KAAK,EAAE,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,eAAe,CAAC,6CAA6C,EAAE,aAAa,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACjJ,CAAC;IACF,CAAC,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAAC,OAAqB;IACzD,OAAO;QACN,aAAa,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;QAC3E,YAAY,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC;QACrE,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;KACnE,CAAC;AACH,CAAC;AAED,eAAe,2BAA2B,CAAC;IAC1C,IAAI,EAAE,SAAS;IACf,EAAE,EAAE,6BAA6B;IACjC,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;IACnC,cAAc,EAAE;QACf,OAAO,EAAE,CAAC,OAAqB,EAAE,EAAE,CAAC,2BAA2B,CAAC,OAAO,CAAC;KACxE;CACD,CAAC,CAAC"}

package/dist/realtime/chat.realtime.room.context.impl.consumer.d.ts

@@ -0,0 +1,35 @@
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { type ChatRealtimeRoom, type ChatRoomMessage } from './schemas/room.ts';
+import type { UnifiedChatMessage } from '../schemas/index.ts';
+/**
+ * Consumer-scope chat realtime-room context.
+ *
+ * Off-cloud surfaces (cli/tui/bridge) have NO Durable Object binding, so this
+ * impl resolves the SAME transport-neutral interface over HTTP against
+ * chat.vibes.dev's existing REST endpoints via the canonical `chat` runtime
+ * client (`getVibesClient<ChatApiClient>('chat', runtime)`) — consume-don't-reimplement.
+ *
+ * CONTRACT FIDELITY (Phase 1):
+ *  - `historySince` is faithful for every field the source carries (id, status,
+ *    sender, ids, content, metadata, createdAt). The one approximation is
+ *    `messageType` — `UnifiedChatMessage` carries no discrete message type, so it
+ *    is reported as `'text'`; consumers needing the exact rich type must wait for
+ *    the Phase 2 consumer transport that carries the full row.
+ *  - `appendMessage` is NON-OPERATIONAL. The only existing off-cloud write
+ *    endpoint (`POST /api/chat/send`) accepts `{content, replyToId}` and CANNOT
+ *    preserve the canonical `ChatRoomMessage` (`id`, `status`, `messageType`,
+ *    `metadata`, `createdAt`, or agent/system sender semantics). Rather than
+ *    expose a lossy upsert that silently diverges from the cloud contract, the
+ *    consumer write path is deferred to Phase 2 (a rich append endpoint). It is a
+ *    documented no-op here so a consumer can resolve the interface without being
+ *    misled into thinking a rich append landed.
+ *  - `subscribe` likewise lands in Phase 2 alongside the read/transport cutover
+ *    (the cloud impl's subscribe is already real); a no-op unsubscribe until then.
+ */
+/** Map a UnifiedChatMessage to the rich room shape, preserving every field it carries. */
+export declare function toRoomMessage(m: UnifiedChatMessage): ChatRoomMessage;
+declare const _default: import("@vibesdotdev/kernel").RuntimeImplementationWrapper<{
+    provide: (runtime: VibesRuntime) => ChatRealtimeRoom;
+}>;
+export default _default;
+//# sourceMappingURL=chat.realtime.room.context.impl.consumer.d.ts.map

package/dist/realtime/chat.realtime.room.context.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.realtime.room.context.impl.consumer.d.ts","sourceRoot":"","sources":["../../src/realtime/chat.realtime.room.context.impl.consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGrF,OAAO,EAEN,KAAK,gBAAgB,EAErB,KAAK,eAAe,EAEpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,CAAC,EAAE,kBAAkB,GAAG,eAAe,CAiBpE;;uBAmDoB,YAAY;;AALjC,wBAOG"}

package/dist/realtime/chat.realtime.room.context.impl.consumer.js

@@ -0,0 +1,86 @@
+import { createRuntimeImplementation } from '@vibesdotdev/kernel';
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+import { getLogger } from '@vibesdotdev/logging';
+import { CHAT_REALTIME_ROOM_CONTEXT_ID } from "./schemas/room.js";
+/**
+ * Consumer-scope chat realtime-room context.
+ *
+ * Off-cloud surfaces (cli/tui/bridge) have NO Durable Object binding, so this
+ * impl resolves the SAME transport-neutral interface over HTTP against
+ * chat.vibes.dev's existing REST endpoints via the canonical `chat` runtime
+ * client (`getVibesClient<ChatApiClient>('chat', runtime)`) — consume-don't-reimplement.
+ *
+ * CONTRACT FIDELITY (Phase 1):
+ *  - `historySince` is faithful for every field the source carries (id, status,
+ *    sender, ids, content, metadata, createdAt). The one approximation is
+ *    `messageType` — `UnifiedChatMessage` carries no discrete message type, so it
+ *    is reported as `'text'`; consumers needing the exact rich type must wait for
+ *    the Phase 2 consumer transport that carries the full row.
+ *  - `appendMessage` is NON-OPERATIONAL. The only existing off-cloud write
+ *    endpoint (`POST /api/chat/send`) accepts `{content, replyToId}` and CANNOT
+ *    preserve the canonical `ChatRoomMessage` (`id`, `status`, `messageType`,
+ *    `metadata`, `createdAt`, or agent/system sender semantics). Rather than
+ *    expose a lossy upsert that silently diverges from the cloud contract, the
+ *    consumer write path is deferred to Phase 2 (a rich append endpoint). It is a
+ *    documented no-op here so a consumer can resolve the interface without being
+ *    misled into thinking a rich append landed.
+ *  - `subscribe` likewise lands in Phase 2 alongside the read/transport cutover
+ *    (the cloud impl's subscribe is already real); a no-op unsubscribe until then.
+ */
+/** Map a UnifiedChatMessage to the rich room shape, preserving every field it carries. */
+export function toRoomMessage(m) {
+    const createdAtMs = Date.parse(m.createdAt);
+    return {
+        id: m.id,
+        chatRoomId: m.roomId,
+        status: m.status ?? null,
+        userId: m.userId ?? null,
+        agentId: m.agentId ?? null,
+        replyToId: m.replyToId ?? null,
+        // UnifiedChatMessage carries no discrete messageType (see contract note above);
+        // reported as 'text' until the Phase 2 transport carries the full row.
+        messageType: 'text',
+        senderType: m.senderType,
+        content: m.content ?? null,
+        metadata: m.metadata ?? null,
+        createdAt: Number.isFinite(createdAtMs) ? createdAtMs : 0
+    };
+}
+async function client(runtime) {
+    return getVibesClient('chat', runtime);
+}
+/**
+ * NON-OPERATIONAL in Phase 1 (see contract note). Deliberately does NOT route to
+ * `sendMessage`, which would drop the rich fields and create a divergent message.
+ * Never-throws to honor the interface's best-effort contract.
+ */
+async function appendMessage(runtime, roomId, message) {
+    getLogger('chat.realtime.room.consumer', runtime).warn('[chat.realtime-room] consumer appendMessage is non-operational in Phase 1 (no rich off-cloud append endpoint); dropping', { roomId, messageId: message.id });
+}
+async function historySince(runtime, roomId, query = {}) {
+    // A failed read rejects typed (the client's refusal); it is never an empty history.
+    const c = await client(runtime);
+    const since = query.since != null ? new Date(query.since).toISOString() : undefined;
+    const messages = await c.listMessages(roomId, { limit: query.limit, since });
+    return messages.map(toRoomMessage).sort((a, b) => a.createdAt - b.createdAt);
+}
+async function subscribe(_roomId, _onEvent) {
+    // Phase 2: wire the consumer SSE/WS transport for TUI/bridge here.
+    return () => { };
+}
+function createConsumerChatRealtimeRoom(runtime) {
+    return {
+        appendMessage: (roomId, message) => appendMessage(runtime, roomId, message),
+        historySince: (roomId, query) => historySince(runtime, roomId, query),
+        subscribe
+    };
+}
+export default createRuntimeImplementation({
+    kind: 'context',
+    id: CHAT_REALTIME_ROOM_CONTEXT_ID,
+    constraint: { hardware: ['consumer'] },
+    implementation: {
+        provide: (runtime) => createConsumerChatRealtimeRoom(runtime)
+    }
+});
+//# sourceMappingURL=chat.realtime.room.context.impl.consumer.js.map

package/dist/realtime/chat.realtime.room.context.impl.consumer.js.map

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

package/dist/realtime/publisher.d.ts

@@ -0,0 +1,36 @@
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+export { REALTIME_SSE_HUB_CONTEXT_ID } from '@vibesdotdev/realtime';
+import type { ChatEventPayload, ChatInboxEventPayload, ChatRealtimeTurnStream, PresenceEventPayload, TypingEventPayload } from './schemas/publisher.ts';
+export type { ChatRealtimeTurnStream } from './schemas/publisher.ts';
+export { CHANNEL_RELAY_BINDING, chatInboxRealtimeChannelId, chatRealtimeChannelId, CHAT_REALTIME_PUBLISHER_CONTEXT_ID } from './schemas/publisher.ts';
+/**
+ * Publish one chat event. Without a composed publisher (confirmed absence) it
+ * is delivered on the in-process SSE bus; any other failure rejects typed.
+ */
+export declare function publishChatEvent(runtime: VibesRuntime, payload: ChatEventPayload): Promise<void>;
+/**
+ * Publish one owner Inbox invalidation. A publisher without inbox support, or
+ * confirmed absence, delivers on the in-process owner channel; any other
+ * failure rejects typed.
+ */
+export declare function publishChatInboxEvent(runtime: VibesRuntime, payload: ChatInboxEventPayload): Promise<void>;
+/**
+ * Open a turn-scoped high-frequency stream for a chat room (streaming deltas,
+ * tool cards). Never throws; when the resolved publisher does not support turn
+ * streams (or resolution fails) the returned stream is permanently non-live and
+ * the caller's publishChatEvent path remains the delivery mechanism. The
+ * transport tag is persisted into turn metadata, so a failure contributes its
+ * typed code and reason only, never error text.
+ */
+export declare function openChatTurnStream(runtime: VibesRuntime, roomId: string): Promise<ChatRealtimeTurnStream>;
+/**
+ * Publish one typing event. Without a composed publisher (confirmed absence)
+ * it is delivered in-process; any other failure rejects typed.
+ */
+export declare function publishTypingEvent(runtime: VibesRuntime, payload: TypingEventPayload): Promise<void>;
+/**
+ * Publish one presence event. Without a composed publisher (confirmed
+ * absence) it is delivered in-process; any other failure rejects typed.
+ */
+export declare function publishPresenceEvent(runtime: VibesRuntime, payload: PresenceEventPayload): Promise<void>;
+//# sourceMappingURL=publisher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.d.ts","sourceRoot":"","sources":["../../src/realtime/publisher.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAapE,OAAO,KAAK,EACX,gBAAgB,EAChB,qBAAqB,EAErB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAIrE,OAAO,EACN,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,kCAAkC,EAClC,MAAM,wBAAwB,CAAC;AAkBhC;;;GAGG;AACH,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAQf;AAUD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,sBAAsB,CAAC,CAejC;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/realtime/publisher.js

@@ -0,0 +1,162 @@
+import { settle, valueFreeFailure } from '@vibesdotdev/kernel';
+import { CapabilityError } from '@vibesdotdev/kernel';
+// The SSE hub is the runtime's own, resolved through the owner's accessor in
+// ./sse-hub-helper.ts. This names the hub's owner and re-publishes its context
+// id so an SSE subscriber side resolves the same channel hub this publisher
+// broadcasts on.
+export { REALTIME_SSE_HUB_CONTEXT_ID } from '@vibesdotdev/realtime';
+import { getLogger } from '@vibesdotdev/logging';
+import { getSseHubOrNull } from "./sse-hub-helper.js";
+import { CHANNEL_RELAY_BINDING, CHAT_REALTIME_PUBLISHER_CONTEXT_ID, ChannelRelayNamespaceSchema, ChatRealtimePublisherSchema, chatInboxRealtimeChannelId, chatRealtimeChannelId } from "./schemas/publisher.js";
+import { chatEventSSEData } from "./sse-data.js";
+import { resolveChatContext } from "./resolve-context.js";
+// Re-export the realtime channel helpers so SSE endpoints (the subscriber side)
+// resolve the SAME channel id + DO binding name the cloud publisher uses.
+export { CHANNEL_RELAY_BINDING, chatInboxRealtimeChannelId, chatRealtimeChannelId, CHAT_REALTIME_PUBLISHER_CONTEXT_ID } from "./schemas/publisher.js";
+const LOGGER_ID = 'chat.realtime.publisher';
+/**
+ * Resolve the composed publisher. Confirmed absence is `{ publisher: null }`
+ * (the in-process SSE path then delivers); every other failure, and a
+ * resolved value that is not a publisher, rejects typed.
+ */
+async function resolveChatRealtimePublisher(runtime) {
+    const resolution = await resolveChatContext(runtime, CHAT_REALTIME_PUBLISHER_CONTEXT_ID, ChatRealtimePublisherSchema);
+    return { publisher: resolution.value };
+}
+function logLocalDelivery(runtime, what) {
+    getLogger(LOGGER_ID, runtime).debug('No realtime publisher is composed; delivering in-process', { what });
+}
+/**
+ * Publish one chat event. Without a composed publisher (confirmed absence) it
+ * is delivered on the in-process SSE bus; any other failure rejects typed.
+ */
+export async function publishChatEvent(runtime, payload) {
+    const { publisher } = await resolveChatRealtimePublisher(runtime);
+    if (publisher) {
+        await publisher.publishChatEvent(payload);
+        return;
+    }
+    logLocalDelivery(runtime, 'chat event');
+    await publishChatEventLocally(runtime, payload);
+}
+/**
+ * Publish one owner Inbox invalidation. A publisher without inbox support, or
+ * confirmed absence, delivers on the in-process owner channel; any other
+ * failure rejects typed.
+ */
+export async function publishChatInboxEvent(runtime, payload) {
+    const { publisher } = await resolveChatRealtimePublisher(runtime);
+    if (publisher?.publishChatInboxEvent) {
+        await publisher.publishChatInboxEvent(payload);
+        return;
+    }
+    logLocalDelivery(runtime, 'inbox event');
+    await publishChatInboxEventLocally(runtime, payload);
+}
+/** A turn stream that never delivers — callers use their slow-path publish. */
+const NULL_TURN_STREAM = {
+    transport: 'none',
+    isLive: () => false,
+    send: () => { },
+    close: () => { }
+};
+/**
+ * Open a turn-scoped high-frequency stream for a chat room (streaming deltas,
+ * tool cards). Never throws; when the resolved publisher does not support turn
+ * streams (or resolution fails) the returned stream is permanently non-live and
+ * the caller's publishChatEvent path remains the delivery mechanism. The
+ * transport tag is persisted into turn metadata, so a failure contributes its
+ * typed code and reason only, never error text.
+ */
+export async function openChatTurnStream(runtime, roomId) {
+    const opened = await settle(async () => {
+        const { publisher } = await resolveChatRealtimePublisher(runtime);
+        if (!publisher)
+            return NULL_TURN_STREAM;
+        if (!publisher.openTurnStream) {
+            // Whether the relay DO binding is visible from this isolate: the POST path needs it too.
+            const hasBinding = runtime.getBinding(CHANNEL_RELAY_BINDING, ChannelRelayNamespaceSchema) ? '1' : '0';
+            return { ...NULL_TURN_STREAM, transport: `no-method[relayBinding=${hasBinding}]` };
+        }
+        return await publisher.openTurnStream(chatRealtimeChannelId(roomId));
+    });
+    if (opened.ok)
+        return opened.value;
+    const failure = CapabilityError.from(opened.cause);
+    getLogger(LOGGER_ID, runtime).warn('Chat turn stream could not be opened; the slow path delivers', { failure: valueFreeFailure(opened.cause) });
+    return { ...NULL_TURN_STREAM, transport: `error:${failure.code}:${failure.reason}` };
+}
+/**
+ * Publish one typing event. Without a composed publisher (confirmed absence)
+ * it is delivered in-process; any other failure rejects typed.
+ */
+export async function publishTypingEvent(runtime, payload) {
+    const { publisher } = await resolveChatRealtimePublisher(runtime);
+    if (publisher) {
+        await publisher.publishTypingEvent(payload);
+        return;
+    }
+    logLocalDelivery(runtime, 'typing event');
+    const hub = await getSseHubOrNull(runtime);
+    hub?.broadcastToChannel(`chat:${payload.chatRoomId}:typing`, {
+        type: 'typing',
+        data: {
+            chatRoomId: payload.chatRoomId,
+            userId: payload.userId,
+            isTyping: payload.isTyping
+        }
+    });
+}
+/**
+ * Publish one presence event. Without a composed publisher (confirmed
+ * absence) it is delivered in-process; any other failure rejects typed.
+ */
+export async function publishPresenceEvent(runtime, payload) {
+    const { publisher } = await resolveChatRealtimePublisher(runtime);
+    if (publisher) {
+        await publisher.publishPresenceEvent(payload);
+        return;
+    }
+    logLocalDelivery(runtime, 'presence event');
+    const lastSeen = payload.lastSeen ?? new Date().toISOString();
+    const hub = await getSseHubOrNull(runtime);
+    hub?.broadcastToChannel('global:presence', {
+        type: 'presence',
+        data: {
+            userId: payload.userId,
+            status: payload.status,
+            activeRooms: payload.activeRooms,
+            lastSeen
+        }
+    });
+    for (const roomId of payload.activeRooms) {
+        hub?.broadcastToChannel(`chat:${roomId}:presence`, {
+            type: 'presence',
+            data: {
+                chatRoomId: roomId,
+                userId: payload.userId,
+                status: payload.status,
+                lastSeen
+            }
+        });
+    }
+}
+async function publishChatEventLocally(runtime, payload) {
+    const hub = await getSseHubOrNull(runtime);
+    hub?.broadcastToChannel(`chat:${payload.chatRoomId}:messages`, {
+        type: payload.type,
+        data: chatEventSSEData(runtime, payload)
+    });
+}
+async function publishChatInboxEventLocally(runtime, payload) {
+    const hub = await getSseHubOrNull(runtime);
+    hub?.broadcastToChannel(chatInboxRealtimeChannelId(payload.ownerId), {
+        type: 'inbox.invalidate',
+        data: {
+            type: 'invalidate',
+            roomId: payload.chatRoomId,
+            messageId: payload.messageId
+        }
+    });
+}
+//# sourceMappingURL=publisher.js.map

package/dist/realtime/publisher.js.map

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

package/dist/realtime/resolve-context.d.ts

@@ -0,0 +1,17 @@
+import type * as z from 'zod/v4';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+/** A resolved Chat context, or confirmed absence: the context (or the `context` kind) is not composed. */
+export type ChatContextResolution<T> = {
+    readonly value: T;
+} | {
+    readonly value: null;
+};
+/**
+ * Resolve one Chat-owned `context` by id. Confirmed absence — the runtime's
+ * typed `NOT_FOUND` for this context id, or for the `context` kind itself —
+ * is `{ value: null }`, which a caller may degrade on. Every other resolution
+ * failure rejects `UNAVAILABLE`, and a resolved value its schema refuses
+ * rejects `INTERNAL`: neither is ever treated as absence.
+ */
+export declare function resolveChatContext<Schema extends z.ZodType>(runtime: VibesRuntime, contextId: string, schema: Schema): Promise<ChatContextResolution<z.output<Schema>>>;
+//# sourceMappingURL=resolve-context.d.ts.map

package/dist/realtime/resolve-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-context.d.ts","sourceRoot":"","sources":["../../src/realtime/resolve-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAwC,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG9F,0GAA0G;AAC1G,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;CAAE,CAAC;AAExF;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EAChE,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAsBlD"}

package/dist/realtime/resolve-context.js

@@ -0,0 +1,34 @@
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { parseChatUntrusted } from "../utils/parse-guard.js";
+/**
+ * Resolve one Chat-owned `context` by id. Confirmed absence — the runtime's
+ * typed `NOT_FOUND` for this context id, or for the `context` kind itself —
+ * is `{ value: null }`, which a caller may degrade on. Every other resolution
+ * failure rejects `UNAVAILABLE`, and a resolved value its schema refuses
+ * rejects `INTERNAL`: neither is ever treated as absence.
+ */
+export async function resolveChatContext(runtime, contextId, schema) {
+    let resolved;
+    try {
+        resolved = parseChatUntrusted(schema, await runtime.query('context').withId(contextId).resolve());
+    }
+    catch (error) {
+        const failure = CaughtFailureSchema.parse(error);
+        if (CapabilityError.isAbsenceOf(failure, 'context', contextId) || CapabilityError.isAbsenceOf(failure, 'runtime/kind', 'context')) {
+            return { value: null };
+        }
+        throw new CapabilityError(`The ${contextId} context could not be resolved.`, 'UNAVAILABLE', {
+            reason: 'chat-context-unresolved',
+            details: { contextId },
+            cause: error
+        });
+    }
+    if (resolved.outcome !== 'parsed') {
+        throw new CapabilityError(`The ${contextId} context does not implement its contract.`, 'INTERNAL', {
+            reason: 'chat-context-invalid',
+            details: { contextId }
+        });
+    }
+    return { value: resolved.data };
+}
+//# sourceMappingURL=resolve-context.js.map

package/dist/realtime/resolve-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-context.js","sourceRoot":"","sources":["../../src/realtime/resolve-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAqB,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAA2B,MAAM,yBAAyB,CAAC;AAKtF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,OAAqB,EACrB,SAAiB,EACjB,MAAc;IAEd,IAAI,QAA8C,CAAC;IACnD,IAAI,CAAC;QACJ,QAAQ,GAAG,kBAAkB,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,eAAe,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,eAAe,CAAC,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,CAAC;YACnI,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACxB,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,OAAO,SAAS,iCAAiC,EAAE,aAAa,EAAE;YAC3F,MAAM,EAAE,yBAAyB;YACjC,OAAO,EAAE,EAAE,SAAS,EAAE;YACtB,KAAK,EAAE,KAAK;SACZ,CAAC,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,IAAI,eAAe,CAAC,OAAO,SAAS,2CAA2C,EAAE,UAAU,EAAE;YAClG,MAAM,EAAE,sBAAsB;YAC9B,OAAO,EAAE,EAAE,SAAS,EAAE;SACtB,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/dist/realtime/room.d.ts

@@ -0,0 +1,24 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { ChatRoomHistoryQuery, ChatRoomMessage, ChatRoomRealtimeEvent } from './schemas/room.ts';
+export { CHAT_ROOM_BINDING, CHAT_REALTIME_ROOM_CONTEXT_ID, chatRealtimeRoomName } from './schemas/room.ts';
+export type { ChatRealtimeRoom, ChatRoomHistoryQuery, ChatRoomMessage, ChatRoomRealtimeEvent } from './schemas/room.ts';
+/**
+ * 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 declare function appendRoomMessage(runtime: VibesRuntime, roomId: string, message: ChatRoomMessage): Promise<void>;
+/**
+ * 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 declare function getRoomHistorySince(runtime: VibesRuntime, roomId: string, query?: ChatRoomHistoryQuery): Promise<ChatRoomMessage[]>;
+/**
+ * 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 declare function subscribeRoomEvents(runtime: VibesRuntime, roomId: string, onEvent: (event: ChatRoomRealtimeEvent) => void): Promise<() => void>;
+//# sourceMappingURL=room.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../../src/realtime/room.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD,OAAO,KAAK,EAEX,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,EACN,iBAAiB,EACjB,6BAA6B,EAC7B,oBAAoB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACX,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,MAAM,mBAAmB,CAAC;AAc3B;;;;GAIG;AACH,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,eAAe,EAAE,CAAC,CAO5B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GAC7C,OAAO,CAAC,MAAM,IAAI,CAAC,CAOrB"}