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

package/dist/client/tool-run-events.js

@@ -0,0 +1,127 @@
+/**
+ * Fold a live `tool.*` run event into the assistant message's toolCalls list.
+ *
+ * The Svelte store used to ignore these events, so editor chat showed no card
+ * until the turn persisted. Room-level live state already uses this shape;
+ * keep one upsert so stream, poll, and persist share an id space.
+ */
+import * as z from 'zod/v4';
+import { toolCallRecordSchema, toolCallStatusSchema } from "../schemas/unified.js";
+function replaceAt(calls, index, next) {
+    if (index < 0)
+        return [...calls, next];
+    return calls.map((call, i) => (i === index ? next : call));
+}
+/**
+ * The native agent loop returns tool failures as RESULTS, not throws:
+ * `{ok:false, error, retryable}` (see `executeToolCall`). Strict shape gate —
+ * only that envelope flips a completion to failed; domain data that happens
+ * to carry `ok:false` keeps its success card.
+ */
+const ToolFailureEnvelopeSchema = z.object({ ok: z.literal(false), error: z.string().min(1) });
+export function readToolFailureMessage(output) {
+    const envelope = ToolFailureEnvelopeSchema.safeParse(output);
+    return envelope.success ? envelope.data.error : null;
+}
+export function applyToolRunEventToCalls(calls, event, now = new Date().toISOString()) {
+    if (event.type === 'tool.started') {
+        const existing = calls.findIndex((call) => call.toolCallId === event.toolCallId);
+        const base = existing >= 0 ? calls[existing] : undefined;
+        return replaceAt(calls, existing, {
+            toolCallId: event.toolCallId,
+            toolId: event.toolName,
+            toolName: event.toolName,
+            name: event.toolName,
+            input: event.args ?? base?.input,
+            status: 'running',
+            startedAt: base?.startedAt ?? now
+        });
+    }
+    const toolName = 'toolName' in event && event.toolName ? event.toolName : '';
+    const index = calls.findIndex((call) => call.toolCallId === event.toolCallId);
+    const current = index >= 0
+        ? calls[index]
+        : {
+            toolCallId: event.toolCallId,
+            toolId: toolName || 'unknown-tool',
+            toolName: toolName || 'unknown-tool',
+            name: toolName || 'unknown-tool',
+            input: undefined,
+            status: 'running',
+            startedAt: now
+        };
+    if (event.type === 'tool.progress') {
+        if (event.status === 'awaiting_approval') {
+            return replaceAt(calls, index, {
+                ...current,
+                status: 'awaiting_approval',
+                approval: { required: true, decision: 'pending' }
+            });
+        }
+        if (event.status === 'running') {
+            return replaceAt(calls, index, { ...current, status: 'running' });
+        }
+        if (event.status === 'denied') {
+            return replaceAt(calls, index, {
+                ...current,
+                status: 'denied',
+                error: 'Denied by user',
+                completedAt: now,
+                approval: { required: true, decision: 'denied' }
+            });
+        }
+        if (event.status === 'cancelled' || event.status === 'interrupted') {
+            return replaceAt(calls, index, {
+                ...current,
+                status: event.status,
+                error: event.status === 'cancelled' ? 'Cancelled by user' : 'Interrupted before completion',
+                completedAt: now
+            });
+        }
+        const status = toolCallStatusSchema.safeParse(event.status);
+        return status.success ? replaceAt(calls, index, { ...current, status: status.data }) : calls;
+    }
+    if (event.type === 'tool.completed') {
+        const failure = readToolFailureMessage(event.output);
+        const completed = {
+            ...current,
+            toolCallId: event.toolCallId,
+            toolId: event.toolName,
+            toolName: event.toolName,
+            name: event.toolName,
+            output: event.output,
+            status: failure ? 'failed' : 'completed',
+            completedAt: now,
+            durationMs: event.durationMs
+        };
+        if (event.rewrittenFrom)
+            completed.rewrittenFrom = event.rewrittenFrom;
+        if (failure)
+            completed.error = failure;
+        if (current.approval?.decision === 'pending')
+            completed.approval = { ...current.approval, decision: 'approved' };
+        return replaceAt(calls, index, completed);
+    }
+    return replaceAt(calls, index, {
+        ...current,
+        toolCallId: event.toolCallId,
+        toolId: event.toolName,
+        toolName: event.toolName,
+        name: event.toolName,
+        status: 'failed',
+        error: event.error,
+        completedAt: now
+    });
+}
+const LiveToolCallsSchema = z.object({ toolCalls: z.array(z.unknown()) });
+/** The tool calls a message's metadata records; a malformed record is skipped. */
+export function readLiveToolCalls(metadata) {
+    const container = LiveToolCallsSchema.safeParse(metadata);
+    if (!container.success)
+        return [];
+    return container.data.toolCalls.flatMap((item) => {
+        const parsed = toolCallRecordSchema.safeParse(item);
+        return parsed.success ? [{ ...parsed.data, name: parsed.data.toolName }] : [];
+    });
+}
+//# sourceMappingURL=tool-run-events.js.map

package/dist/client/tool-run-events.js.map

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

package/dist/client/web/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @vibesdotdev/chat/client/web
+ *
+ * HTTP-backed chat client for browser and server-to-server contexts.
+ * Implements ChatClient/ChatRoom from contracts.ts so consumers can swap
+ * between web and runtime backends without code changes.
+ */
+export { WebChatClient, type WebChatClientOptions } from './web-chat-client.ts';
+export { WebChatRoom } from './web-chat-room.ts';
+export { WebHttpClient, WebHttpError, type WebHttpOptions } from './web-http.ts';
+export { WebRoomStream, streamMessageToUnified, type RoomStreamEvent, type RoomStreamMessageEvent, type RoomStreamTypingEvent, type RoomStreamPresenceEvent } from './web-room-stream.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/web/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/web/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EACN,aAAa,EACb,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,MAAM,sBAAsB,CAAC"}

package/dist/client/web/index.js

@@ -0,0 +1,12 @@
+/**
+ * @vibesdotdev/chat/client/web
+ *
+ * HTTP-backed chat client for browser and server-to-server contexts.
+ * Implements ChatClient/ChatRoom from contracts.ts so consumers can swap
+ * between web and runtime backends without code changes.
+ */
+export { WebChatClient } from "./web-chat-client.js";
+export { WebChatRoom } from "./web-chat-room.js";
+export { WebHttpClient, WebHttpError } from "./web-http.js";
+export { WebRoomStream, streamMessageToUnified } from "./web-room-stream.js";
+//# sourceMappingURL=index.js.map

package/dist/client/web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/web/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAA6B,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAuB,MAAM,eAAe,CAAC;AACjF,OAAO,EACN,aAAa,EACb,sBAAsB,EAKtB,MAAM,sBAAsB,CAAC"}

package/dist/client/web/internals/web-chat-room.cache.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Web Chat Room Cache — in-memory message + participant store.
+ *
+ * Extracted from web-chat-room.ts. Manages the Map-based caches and
+ * subscriber notification for messages and participants.
+ *
+ * Kept deliberately stateless w.r.t. HTTP — the caller (WebChatRoom)
+ * owns the HTTP client and passes fetched data in.
+ */
+import type { UnifiedChatMessage, ChatRoomParticipant } from '../../../schemas/unified.ts';
+import type { Unsubscribe } from '../../schemas/contracts.ts';
+import { WebHttpClient } from '../web-http.ts';
+export declare class WebChatRoomCache {
+    readonly messagesById: Map<string, {
+        id: string;
+        roomId: string;
+        senderType: "agent" | "user" | "system";
+        role: "user" | "system" | "assistant";
+        content: string;
+        status: "cancelled" | "failed" | "queued" | "streaming" | "sending" | "sent" | "pending" | "declined" | "processing" | "completed";
+        createdAt: string;
+        messageType?: "error" | "text" | "image" | "image_url" | "video_url" | "tool_request" | "tool_response" | "knowledge_result" | undefined;
+        userId?: string | undefined;
+        agentId?: string | undefined;
+        attachments?: {
+            id: string;
+            fileName: string;
+            contentType: string;
+            size: number;
+            url: string;
+            createdAt: string;
+        }[] | undefined;
+        streaming?: boolean | undefined;
+        cancelled?: boolean | undefined;
+        replyToId?: string | undefined;
+        metadata?: {
+            [x: string]: unknown;
+            segments?: ({
+                kind: "text";
+                text: string;
+            } | {
+                kind: "thinking";
+                text: string;
+                startedAt?: string | undefined;
+                durationMs?: number | undefined;
+            } | {
+                kind: "tool";
+                toolCallId: string;
+            })[] | undefined;
+            contentBlocks?: {
+                thinking: string;
+                message: string;
+            } | undefined;
+            toolCalls?: {
+                toolCallId: string;
+                toolId: string;
+                toolName: string;
+                status: "denied" | "cancelled" | "failed" | "timeout" | "pending" | "completed" | "awaiting_approval" | "running" | "interrupted";
+                startedAt: string;
+                rewrittenFrom?: {
+                    toolId: string;
+                    command: string;
+                } | undefined;
+                input?: unknown;
+                output?: unknown;
+                error?: string | undefined;
+                completedAt?: string | undefined;
+                durationMs?: number | undefined;
+                approval?: {
+                    required?: boolean | undefined;
+                    requestId?: string | undefined;
+                    expiresAt?: string | undefined;
+                    respondedAt?: string | undefined;
+                    decision?: "denied" | "timeout" | "pending" | "approved" | undefined;
+                    reason?: string | undefined;
+                    approverId?: string | undefined;
+                } | undefined;
+                events?: {
+                    id: string;
+                    type: string;
+                    toolCallId: string;
+                    toolName: string;
+                    timestamp: string;
+                    status?: string | undefined;
+                    args?: Record<string, unknown> | undefined;
+                    output?: unknown;
+                    error?: string | {
+                        message?: string | undefined;
+                        code?: string | undefined;
+                    } | undefined;
+                    approvalMode?: string | undefined;
+                }[] | undefined;
+            }[] | undefined;
+            reasoningSteps?: {
+                id: string;
+                thought: string;
+                timestamp: string;
+                action?: string | undefined;
+                observation?: string | undefined;
+            }[] | undefined;
+            messageParts?: {
+                id: string;
+                messageId: string;
+                sequence: number;
+                content: string;
+                timestamp: string;
+                streaming?: boolean | undefined;
+            }[] | undefined;
+            error?: string | undefined;
+            usage?: {
+                promptTokens?: number | undefined;
+                completionTokens?: number | undefined;
+                totalTokens?: number | undefined;
+            } | undefined;
+            durationMs?: number | undefined;
+            generationId?: string | undefined;
+            agentName?: string | undefined;
+            agentAlias?: string | undefined;
+            generating?: boolean | undefined;
+        } | undefined;
+        updatedAt?: string | undefined;
+    }>;
+    readonly participantsByKey: Map<string, {
+        id: string;
+        type: "agent" | "friend";
+        name: string;
+        responseStyle: "never" | "always" | "auto" | "reply";
+        enabled: boolean;
+        description?: string | undefined;
+        modelHint?: string | undefined;
+        order?: number | undefined;
+        source?: "config" | "runtime" | "pairing" | "history" | undefined;
+    }>;
+    private readonly messageSubscribers;
+    private readonly participantSubscribers;
+    private historyLoaded;
+    upsert(msg: UnifiedChatMessage): void;
+    list(): UnifiedChatMessage[];
+    get(id: string): UnifiedChatMessage | null;
+    remove(id: string): boolean;
+    clearMessages(): void;
+    notifyMessages(): void;
+    notifyParticipants(): void;
+    subscribeMessages(cb: (messages: UnifiedChatMessage[]) => void): Unsubscribe;
+    subscribeParticipants(cb: (participants: ChatRoomParticipant[]) => void): Unsubscribe;
+    /**
+     * Load the room's history once. A failed read rejects typed (the HTTP
+     * client's refusal) and leaves history unloaded, so the next call retries;
+     * it is never an empty history.
+     */
+    ensureHistoryLoaded(roomId: string, http: WebHttpClient): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=web-chat-room.cache.d.ts.map

package/dist/client/web/internals/web-chat-room.cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-chat-room.cache.d.ts","sourceRoot":"","sources":["../../../../src/client/web/internals/web-chat-room.cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAM/C,qBAAa,gBAAgB;IAC5B,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAyC;IAC9D,QAAQ,CAAC,iBAAiB;;;;;;;;;;OAA0C;IAEpE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAuD;IAC1F,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAEnC;IAEJ,OAAO,CAAC,aAAa,CAAS;IAI9B,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI;IAKrC,IAAI,IAAI,kBAAkB,EAAE;IAS5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAI1C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAM3B,aAAa,IAAI,IAAI;IAOrB,cAAc,IAAI,IAAI;IAKtB,kBAAkB,IAAI,IAAI;IAO1B,iBAAiB,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,IAAI,GAAG,WAAW;IAM5E,qBAAqB,CAAC,EAAE,EAAE,CAAC,YAAY,EAAE,mBAAmB,EAAE,KAAK,IAAI,GAAG,WAAW;IAQrF;;;;OAIG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB7E,OAAO,IAAI,IAAI;CAIf"}

package/dist/client/web/internals/web-chat-room.cache.js

@@ -0,0 +1,90 @@
+/**
+ * Web Chat Room Cache — in-memory message + participant store.
+ *
+ * Extracted from web-chat-room.ts. Manages the Map-based caches and
+ * subscriber notification for messages and participants.
+ *
+ * Kept deliberately stateless w.r.t. HTTP — the caller (WebChatRoom)
+ * owns the HTTP client and passes fetched data in.
+ */
+import { WebHttpClient } from "../web-http.js";
+import { normalizeServerMessage } from "../web-helpers.js";
+const HISTORY_LIMIT = 50;
+export class WebChatRoomCache {
+    messagesById = new Map();
+    participantsByKey = new Map();
+    messageSubscribers = new Set();
+    participantSubscribers = new Set();
+    historyLoaded = false;
+    // -- message CRUD ---------------------------------------------------------
+    upsert(msg) {
+        this.messagesById.set(msg.id, msg);
+        this.notifyMessages();
+    }
+    list() {
+        // Plain code-unit comparison: createdAt is an ISO-8601 string, which sorts
+        // chronologically byte-wise. This runs on every SSE frame — localeCompare
+        // (Intl collation) here was a measurable per-frame tax.
+        return Array.from(this.messagesById.values()).sort((a, b) => a.createdAt < b.createdAt ? -1 : a.createdAt > b.createdAt ? 1 : a.id < b.id ? -1 : a.id > b.id ? 1 : 0);
+    }
+    get(id) {
+        return this.messagesById.get(id) ?? null;
+    }
+    remove(id) {
+        const had = this.messagesById.delete(id);
+        if (had)
+            this.notifyMessages();
+        return had;
+    }
+    clearMessages() {
+        this.messagesById.clear();
+        this.notifyMessages();
+    }
+    // -- notifications --------------------------------------------------------
+    notifyMessages() {
+        const snapshot = this.list();
+        for (const cb of this.messageSubscribers)
+            cb(snapshot);
+    }
+    notifyParticipants() {
+        const snapshot = Array.from(this.participantsByKey.values());
+        for (const cb of this.participantSubscribers)
+            cb(snapshot);
+    }
+    // -- subscriptions --------------------------------------------------------
+    subscribeMessages(cb) {
+        this.messageSubscribers.add(cb);
+        cb(this.list());
+        return () => this.messageSubscribers.delete(cb);
+    }
+    subscribeParticipants(cb) {
+        this.participantSubscribers.add(cb);
+        cb(Array.from(this.participantsByKey.values()));
+        return () => this.participantSubscribers.delete(cb);
+    }
+    // -- history loading ------------------------------------------------------
+    /**
+     * Load the room's history once. A failed read rejects typed (the HTTP
+     * client's refusal) and leaves history unloaded, so the next call retries;
+     * it is never an empty history.
+     */
+    async ensureHistoryLoaded(roomId, http) {
+        if (this.historyLoaded)
+            return;
+        const response = await http.get(`/api/chat/rooms/${roomId}/messages?limit=${HISTORY_LIMIT}&summary=false`);
+        const rows = response.messages ?? response.items ?? [];
+        for (const raw of rows) {
+            const msg = normalizeServerMessage(raw, roomId);
+            if (msg)
+                this.messagesById.set(msg.id, msg);
+        }
+        this.historyLoaded = true;
+        this.notifyMessages();
+    }
+    // -- teardown -------------------------------------------------------------
+    dispose() {
+        this.messageSubscribers.clear();
+        this.participantSubscribers.clear();
+    }
+}
+//# sourceMappingURL=web-chat-room.cache.js.map

package/dist/client/web/internals/web-chat-room.cache.js.map

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

package/dist/client/web/internals/web-chat-room.stream.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Web Chat Room Stream Wiring — SSE event handling + pending turn tracking.
+ *
+ * Extracted from web-chat-room.ts. Manages the lifecycle of the SSE
+ * subscription for a single room and correlates agent replies with the
+ * user messages that triggered them (pendingTurns).
+ *
+ * Does not own the WebRoomStream — the caller passes it in, and this
+ * module subscribes/unsubscribes as needed.
+ */
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import type { ChatRunEvent, ChatRunResult, Unsubscribe } from '../../schemas/contracts.ts';
+import { WebRoomStream } from '../web-room-stream.ts';
+import type { RoomStreamApprovalEvent } from '../schemas/index.ts';
+import { WebChatRoomCache } from './web-chat-room.cache.ts';
+export declare class WebChatRoomStreamWiring {
+    private readonly runtime;
+    private readonly roomId;
+    private readonly stream;
+    private readonly cache;
+    private readonly emitEvent;
+    /** Overridable for tests; defaults to STALL_TIMEOUT_MS. */
+    private readonly stallTimeoutMs;
+    /** Overridable for tests; defaults to the server absolute turn horizon plus margin. */
+    private readonly hardTimeoutMs;
+    /** Overridable for tests; gives the model time to continue after tool results. */
+    private readonly postToolActivityGraceMs;
+    /** Overridable for tests; how long a typing indicator stays lit. */
+    private readonly typingExpiryMs;
+    private streamUnsub;
+    private subscriptionLeases;
+    private readonly pendingTurns;
+    /** Users currently lit as "typing", each with a pending auto-expiry timer. */
+    private readonly typingUsers;
+    private readonly typingTimers;
+    /** Online users → epoch-ms of their last observed activity (offline = absent). */
+    private readonly onlineUsers;
+    constructor(runtime: Pick<RuntimeRef, 'lifecycle'>, roomId: string, stream: Pick<WebRoomStream, 'subscribe' | 'close'>, cache: WebChatRoomCache, emitEvent: (event: ChatRunEvent) => void, 
+    /** Overridable for tests; defaults to STALL_TIMEOUT_MS. */
+    stallTimeoutMs?: number, 
+    /** Overridable for tests; defaults to the server absolute turn horizon plus margin. */
+    hardTimeoutMs?: number, 
+    /** Overridable for tests; gives the model time to continue after tool results. */
+    postToolActivityGraceMs?: number, 
+    /** Overridable for tests; how long a typing indicator stays lit. */
+    typingExpiryMs?: number);
+    /**
+     * A server-side run paused on a dangerous tool and is awaiting a decision.
+     * WebChatRoom sets this to consult its registered approval handler and POST
+     * the result to the room's approvals endpoint (fail-closed to deny when no
+     * handler). A method (not a constructor arg) so existing positional callers
+     * — the timeout overrides in the GH #579 tests — are untouched.
+     */
+    private onApprovalRequired;
+    setApprovalRequiredHandler(handler: (event: RoomStreamApprovalEvent) => void): void;
+    /**
+     * Open the SSE subscription for this room. Idempotent — subsequent
+     * calls reuse the same EventSource.
+     */
+    ensureSubscribed(): void;
+    /**
+     * A renderer can be reopened after the projection host died. There is no
+     * pending promise in that new renderer, so the normal stall watchdog cannot
+     * run. Reconcile old streaming snapshots with stale tool activity here and
+     * make the interruption visible instead of reviving a forever-running card.
+     */
+    reconcileInterruptedTurns(now?: number): void;
+    /**
+     * Hold the room transport open for one realtime consumer. Every consumer gets
+     * its own idempotent release; the underlying EventSource is shared and closes
+     * as soon as the final lease is released.
+     */
+    acquireSubscription(): Unsubscribe;
+    /**
+     * Wait for an assistant reply correlated with `userMessageId`.
+     * Resolves when the SSE stream delivers a matching agent message,
+     * or rejects after the server turn horizon plus margin.
+     */
+    awaitGeneration(userMessageId: string, startedAt: number): Promise<ChatRunResult>;
+    private resultForReply;
+    /**
+     * Resolve a turn whose chunks went silent without a terminal message.
+     * Emits a synthetic `done` so the composer + streaming state reset, using
+     * the latest cached content for the streaming assistant message.
+     */
+    private settleStalledTurn;
+    /** Find the in-flight assistant message replying to `userMessageId`, if any. */
+    private findStreamingReply;
+    /**
+     * Settle all pending turns as locally cancelled. The accepted user message is
+     * still true and server work may continue, so cancellation is a successful
+     * local completion state rather than a rejected send.
+     */
+    cancelAll(): void;
+    /**
+     * Tear down the SSE subscription and clear all state.
+     */
+    close(): void;
+    private stopSubscription;
+    private handleStreamEvent;
+    /**
+     * Light (or extinguish) a user's typing indicator. A `typing` frame lights it
+     * and (re)arms an auto-expiry so a dropped "stop" frame can never leave the
+     * user stuck "typing…"; an explicit stop clears it immediately. Either way we
+     * re-emit the full current set so consumers replace their view state.
+     */
+    private handleTyping;
+    /**
+     * Record a presence transition. `online`/`away` refresh the user's last
+     * activity timestamp; `offline` drops them from the online set. We then emit
+     * the full online roster so consumers can derive online/away/offline.
+     */
+    private handlePresence;
+    private emitTyping;
+    private emitPresence;
+    /** Clear all typing auto-expiry timers (called on close). */
+    private clearTypingTimers;
+}
+//# sourceMappingURL=web-chat-room.stream.d.ts.map

package/dist/client/web/internals/web-chat-room.stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-chat-room.stream.d.ts","sourceRoot":"","sources":["../../../../src/client/web/internals/web-chat-room.stream.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAY,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI3F,OAAO,EAAE,aAAa,EAAgD,MAAM,uBAAuB,CAAC;AACpG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAgC5D,qBAAa,uBAAuB;IAWlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,uFAAuF;IACvF,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,uBAAuB;IACxC,oEAAoE;IACpE,OAAO,CAAC,QAAQ,CAAC,cAAc;IAtBhC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAC/D,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;gBAGvC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,OAAO,CAAC,EAClD,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI;IACzD,2DAA2D;IAC1C,cAAc,GAAE,MAAyB;IAC1D,uFAAuF;IACtE,aAAa,GAAE,MAAmC;IACnE,kFAAkF;IACjE,uBAAuB,GAAE,MAA0C;IACpF,oEAAoE;IACnD,cAAc,GAAE,MAAyB;IAG3D;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB,CAAsD;IAEhF,0BAA0B,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,IAAI;IAMnF;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IAMxB;;;;;OAKG;IACF,yBAAyB,CAAC,GAAG,SAAa,GAAG,IAAI;IAwBlD;;;;OAIG;IACH,mBAAmB,IAAI,WAAW;IAYlC;;;;OAIG;IACH,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA2DjF,OAAO,CAAC,cAAc;IAoBtB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAoDzB,gFAAgF;IAChF,OAAO,CAAC,kBAAkB;IAS1B;;;;OAIG;IACH,SAAS,IAAI,IAAI;IAcjB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,iBAAiB;IAiHzB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAqBpB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IAOpB,6DAA6D;IAC7D,OAAO,CAAC,iBAAiB;CAMzB"}