@essentialai/cogent-bridge 1.0.0

package/dist/cloud/message-inbox.js

@@ -0,0 +1,109 @@
+/**
+ * In-memory message inbox with deduplication and timestamp ordering.
+ *
+ * Aggregates messages from both WebSocket push and poll fallback channels.
+ * Deduplicates by message ID (bounded to last 1000 IDs) and maintains
+ * messages ordered by server timestamp for consistent display.
+ */
+export class MessageInbox {
+    messages = [];
+    seenIds = new Set();
+    seenOrder = [];
+    listeners = [];
+    lastMessageId = null;
+    /**
+     * Add a single message to the inbox.
+     * Returns true if the message was new (not a duplicate).
+     */
+    addMessage(msg) {
+        if (this.seenIds.has(msg.id)) {
+            return false;
+        }
+        // Track for dedup with bounded size
+        this.seenIds.add(msg.id);
+        this.seenOrder.push(msg.id);
+        if (this.seenOrder.length > 1000) {
+            const toRemove = this.seenOrder.shift();
+            this.seenIds.delete(toRemove);
+        }
+        // Insert maintaining timestamp order.
+        // Messages usually arrive in order, so search from the end.
+        let insertIdx = this.messages.length;
+        for (let i = this.messages.length - 1; i >= 0; i--) {
+            if (this.messages[i].timestamp <= msg.timestamp) {
+                insertIdx = i + 1;
+                break;
+            }
+            if (i === 0) {
+                insertIdx = 0;
+            }
+        }
+        this.messages.splice(insertIdx, 0, msg);
+        // Update lastMessageId to the latest message by timestamp
+        const last = this.messages[this.messages.length - 1];
+        this.lastMessageId = last.id;
+        // Notify listeners
+        for (const listener of this.listeners) {
+            listener();
+        }
+        return true;
+    }
+    /**
+     * Add multiple messages at once.
+     * Returns the count of new (non-duplicate) messages added.
+     */
+    addMessages(msgs) {
+        let count = 0;
+        for (const msg of msgs) {
+            if (this.addMessage(msg)) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Get all unread messages (copy of the internal array).
+     */
+    getUnread() {
+        return this.messages.slice();
+    }
+    /**
+     * Mark messages as read by removing them from the unread list.
+     * Does NOT remove from seenIds -- they remain for deduplication.
+     */
+    markRead(messageIds) {
+        const idsToRemove = new Set(messageIds);
+        this.messages = this.messages.filter((m) => !idsToRemove.has(m.id));
+    }
+    /**
+     * Get the ID of the last message received (by timestamp order).
+     * Used for poll sync -- pass as lastMessageId query parameter.
+     */
+    getLastMessageId() {
+        return this.lastMessageId;
+    }
+    /**
+     * Subscribe to new message notifications.
+     * Returns an unsubscribe function.
+     */
+    onNewMessage(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const idx = this.listeners.indexOf(listener);
+            if (idx !== -1) {
+                this.listeners.splice(idx, 1);
+            }
+        };
+    }
+    /**
+     * Clear all state: messages, seen IDs, last message ID, and listeners.
+     */
+    clear() {
+        this.messages = [];
+        this.seenIds = new Set();
+        this.seenOrder = [];
+        this.lastMessageId = null;
+        this.listeners = [];
+    }
+}
+//# sourceMappingURL=message-inbox.js.map

package/dist/cloud/message-inbox.js.map

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

package/dist/cloud/ws-client.d.ts

@@ -0,0 +1,112 @@
+import type { HttpClient } from "./http-client.js";
+import type { MessageRecord } from "../types.js";
+/**
+ * WebSocket connection state machine states.
+ */
+export type WsState = "disconnected" | "connecting" | "connected" | "polling" | "reconnecting";
+/**
+ * Configuration for CloudWsClient.
+ */
+export interface CloudWsClientOptions {
+    /** Server base URL (http:// or https://). */
+    endpoint: string;
+    /** Cloud session ID. */
+    sessionId: string;
+    /** Peer ID. Can be empty string initially (deferred connection). */
+    peerId: string;
+    /** Bearer auth token. */
+    token: string;
+    /** HttpClient instance for poll fallback. */
+    http: HttpClient;
+    /** Callback for a single message from a "message" frame. */
+    onMessage: (msg: MessageRecord) => void;
+    /** Callback for a batch of messages from "queued_messages" frame. */
+    onMessages: (msgs: MessageRecord[]) => void;
+    /** Callback when a peer connects. */
+    onPeerConnected: (peer: {
+        peerId: string;
+        name: string;
+        project: string;
+    }) => void;
+    /** Callback when a peer disconnects. */
+    onPeerDisconnected: (peerId: string) => void;
+    /** Callback for peers snapshot frame. */
+    onPeersSnapshot: (peers: unknown[]) => void;
+    /** Callback for state changes. */
+    onStateChange: (state: WsState) => void;
+    /** Optional callback for error frames from the server. */
+    onError?: (frame: {
+        code: string;
+        message: string;
+    }) => void;
+    /** Poll interval in milliseconds (default: 5000). */
+    pollIntervalMs?: number;
+}
+/**
+ * WebSocket client with reconnection logic and poll fallback.
+ *
+ * Manages the full connection lifecycle:
+ * - Connects to server WS endpoint with token + peerId auth
+ * - Dispatches all 6 WsServerFrame types to callbacks
+ * - Falls back to HTTP polling on disconnect
+ * - Reconnects with exponential backoff (1s-30s with 10% jitter)
+ * - Supports deferred peerId via setPeerId() for lazy connection
+ * - Supports runtime credential updates via updateToken/updateSessionId
+ */
+export declare class CloudWsClient {
+    private ws;
+    private state;
+    private readonly backoff;
+    private reconnectTimer;
+    private pollTimer;
+    private lastMessageId;
+    private opts;
+    constructor(options: CloudWsClientOptions);
+    /**
+     * Initiate WebSocket connection to the server.
+     * Guards against empty peerId -- call setPeerId() first.
+     */
+    connect(): void;
+    /**
+     * Disconnect from the WebSocket and stop all timers.
+     */
+    disconnect(): void;
+    /**
+     * Set or update the peerId.
+     * This is the trigger mechanism for deferred WS connection.
+     * Plan 05 creates CloudWsClient at startup with empty peerId (peerId is
+     * only known after register-peer succeeds). After registration, it calls
+     * this method to initiate the WS connection.
+     */
+    setPeerId(peerId: string): void;
+    /**
+     * Get the current connection state.
+     */
+    getState(): WsState;
+    /**
+     * Update the last seen message ID (e.g., from HttpBackend operations).
+     */
+    updateLastMessageId(id: string): void;
+    /**
+     * Update the auth token for reconnection.
+     * If currently connected, disconnects and reconnects with the new token.
+     */
+    updateToken(newToken: string): void;
+    /**
+     * Update the session ID.
+     * If currently connected, disconnects and reconnects.
+     */
+    updateSessionId(newSessionId: string): void;
+    /**
+     * Replace the HttpClient used for polling.
+     * The next poll cycle will use the new client automatically.
+     */
+    updateHttp(newHttp: HttpClient): void;
+    private setState;
+    private dispatchFrame;
+    private scheduleReconnect;
+    private startPolling;
+    private stopPolling;
+    private clearTimers;
+}
+//# sourceMappingURL=ws-client.d.ts.map

package/dist/cloud/ws-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-client.d.ts","sourceRoot":"","sources":["../../src/cloud/ws-client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,OAAO,GACf,cAAc,GACd,YAAY,GACZ,WAAW,GACX,SAAS,GACT,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,EAAE,UAAU,CAAC;IACjB,4DAA4D;IAC5D,SAAS,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IACxC,qEAAqE;IACrE,UAAU,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;IAC5C,qCAAqC;IACrC,eAAe,EAAE,CAAC,IAAI,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,KAAK,IAAI,CAAC;IACX,wCAAwC;IACxC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,yCAAyC;IACzC,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAC5C,kCAAkC;IAClC,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAKD;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,IAAI,CAAkB;gBAElB,OAAO,EAAE,oBAAoB;IAQzC;;;OAGG;IACH,OAAO,IAAI,IAAI;IA+Df;;OAEG;IACH,UAAU,IAAI,IAAI;IAelB;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAa/B;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIrC;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQnC;;;OAGG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAQ3C;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAQrC,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,YAAY;IAoCpB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,WAAW;CAOpB"}

package/dist/cloud/ws-client.js

@@ -0,0 +1,241 @@
+import WebSocket from "ws";
+import { ExponentialBackoff } from "./backoff.js";
+import { WsCloseCode } from "./ws-frames.js";
+/**
+ * WebSocket client with reconnection logic and poll fallback.
+ *
+ * Manages the full connection lifecycle:
+ * - Connects to server WS endpoint with token + peerId auth
+ * - Dispatches all 6 WsServerFrame types to callbacks
+ * - Falls back to HTTP polling on disconnect
+ * - Reconnects with exponential backoff (1s-30s with 10% jitter)
+ * - Supports deferred peerId via setPeerId() for lazy connection
+ * - Supports runtime credential updates via updateToken/updateSessionId
+ */
+export class CloudWsClient {
+    ws = null;
+    state = "disconnected";
+    backoff;
+    reconnectTimer = null;
+    pollTimer = null;
+    lastMessageId = null;
+    opts;
+    constructor(options) {
+        this.opts = {
+            ...options,
+            pollIntervalMs: options.pollIntervalMs ?? 5000,
+        };
+        this.backoff = new ExponentialBackoff();
+    }
+    /**
+     * Initiate WebSocket connection to the server.
+     * Guards against empty peerId -- call setPeerId() first.
+     */
+    connect() {
+        if (!this.opts.peerId) {
+            console.warn("[CloudWsClient] Cannot connect WebSocket without peerId. Call setPeerId() first.");
+            return;
+        }
+        this.setState("connecting");
+        // Build WS URL: http->ws, https->wss
+        const wsUrl = this.opts.endpoint
+            .replace(/^https:/, "wss:")
+            .replace(/^http:/, "ws:");
+        const sessionPath = `/ws/${this.opts.sessionId}`;
+        const params = new URLSearchParams({
+            token: this.opts.token,
+            peerId: this.opts.peerId,
+        });
+        const url = `${wsUrl}${sessionPath}?${params.toString()}`;
+        const ws = new WebSocket(url);
+        this.ws = ws;
+        ws.on("open", () => {
+            this.setState("connected");
+            this.backoff.reset();
+            this.stopPolling();
+        });
+        ws.on("message", (data) => {
+            try {
+                const frame = JSON.parse(data.toString());
+                this.dispatchFrame(frame);
+            }
+            catch {
+                console.error("[CloudWsClient] Failed to parse WebSocket frame");
+            }
+        });
+        ws.on("close", (code, _reason) => {
+            this.ws = null;
+            // Start polling fallback
+            this.setState("polling");
+            this.startPolling();
+            // Use longer initial delay for service restart
+            if (code === WsCloseCode.SERVICE_RESTART) {
+                // Create a fresh backoff with 5s base for graceful restarts
+                const restartBackoff = new ExponentialBackoff(5000);
+                const delay = restartBackoff.next();
+                this.reconnectTimer = setTimeout(() => this.connect(), delay);
+            }
+            else {
+                this.scheduleReconnect();
+            }
+        });
+        ws.on("error", (err) => {
+            console.error("[CloudWsClient] WebSocket error:", err.message);
+            // Don't change state here -- the "close" event follows and handles it
+        });
+    }
+    /**
+     * Disconnect from the WebSocket and stop all timers.
+     */
+    disconnect() {
+        this.clearTimers();
+        if (this.ws &&
+            (this.ws.readyState === WebSocket.OPEN ||
+                this.ws.readyState === WebSocket.CONNECTING)) {
+            this.ws.close(WsCloseCode.NORMAL_CLOSURE);
+        }
+        this.ws = null;
+        this.setState("disconnected");
+    }
+    /**
+     * Set or update the peerId.
+     * This is the trigger mechanism for deferred WS connection.
+     * Plan 05 creates CloudWsClient at startup with empty peerId (peerId is
+     * only known after register-peer succeeds). After registration, it calls
+     * this method to initiate the WS connection.
+     */
+    setPeerId(peerId) {
+        this.opts.peerId = peerId;
+        if (peerId && this.state === "disconnected") {
+            // Trigger initial connection now that we have a peerId
+            this.connect();
+        }
+        else if (peerId && this.state !== "disconnected") {
+            // Already connected/connecting -- disconnect and reconnect with new peerId
+            this.disconnect();
+            this.connect();
+        }
+    }
+    /**
+     * Get the current connection state.
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Update the last seen message ID (e.g., from HttpBackend operations).
+     */
+    updateLastMessageId(id) {
+        this.lastMessageId = id;
+    }
+    /**
+     * Update the auth token for reconnection.
+     * If currently connected, disconnects and reconnects with the new token.
+     */
+    updateToken(newToken) {
+        this.opts.token = newToken;
+        if (this.state === "connected" || this.state === "connecting") {
+            this.disconnect();
+            this.connect();
+        }
+    }
+    /**
+     * Update the session ID.
+     * If currently connected, disconnects and reconnects.
+     */
+    updateSessionId(newSessionId) {
+        this.opts.sessionId = newSessionId;
+        if (this.state === "connected" || this.state === "connecting") {
+            this.disconnect();
+            this.connect();
+        }
+    }
+    /**
+     * Replace the HttpClient used for polling.
+     * The next poll cycle will use the new client automatically.
+     */
+    updateHttp(newHttp) {
+        this.opts.http = newHttp;
+    }
+    // -------------------------------------------------------------------------
+    // Private methods
+    // -------------------------------------------------------------------------
+    setState(newState) {
+        this.state = newState;
+        this.opts.onStateChange(newState);
+    }
+    dispatchFrame(frame) {
+        switch (frame.type) {
+            case "message":
+                this.opts.onMessage(frame.payload);
+                this.lastMessageId = frame.payload.id;
+                break;
+            case "queued_messages": {
+                const msgs = frame.payload.messages;
+                this.opts.onMessages(msgs);
+                if (msgs.length > 0) {
+                    this.lastMessageId = msgs[msgs.length - 1].id;
+                }
+                break;
+            }
+            case "peer_connected":
+                this.opts.onPeerConnected(frame.payload);
+                break;
+            case "peer_disconnected":
+                this.opts.onPeerDisconnected(frame.payload.peerId);
+                break;
+            case "peers_snapshot":
+                this.opts.onPeersSnapshot(frame.payload.peers);
+                break;
+            case "error":
+                this.opts.onError?.(frame.payload);
+                break;
+        }
+    }
+    scheduleReconnect() {
+        this.setState("reconnecting");
+        const delay = this.backoff.next();
+        this.reconnectTimer = setTimeout(() => this.connect(), delay);
+    }
+    startPolling() {
+        if (this.pollTimer)
+            return;
+        const poll = async () => {
+            try {
+                const path = `/api/sessions/${this.opts.sessionId}/poll`;
+                const query = {
+                    peerId: this.opts.peerId,
+                };
+                if (this.lastMessageId) {
+                    query.lastMessageId = this.lastMessageId;
+                }
+                const result = await this.opts.http.get(path, query);
+                if (result.messages && result.messages.length > 0) {
+                    this.opts.onMessages(result.messages);
+                    this.lastMessageId =
+                        result.messages[result.messages.length - 1].id;
+                }
+            }
+            catch (err) {
+                console.warn("[CloudWsClient] Poll failed:", err instanceof Error ? err.message : String(err));
+            }
+        };
+        // Poll immediately, then at interval
+        void poll();
+        this.pollTimer = setInterval(() => void poll(), this.opts.pollIntervalMs);
+    }
+    stopPolling() {
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+    }
+    clearTimers() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.stopPolling();
+    }
+}
+//# sourceMappingURL=ws-client.js.map

package/dist/cloud/ws-client.js.map

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

package/dist/cloud/ws-frames.d.ts

@@ -0,0 +1,66 @@
+import type { PeerInfo, MessageRecord } from "../types.js";
+/**
+ * WebSocket close codes for different disconnect scenarios.
+ * Uses standard RFC 6455 / IANA-registered codes.
+ */
+export declare const WsCloseCode: {
+    /** Clean client-initiated close. */
+    readonly NORMAL_CLOSURE: 1000;
+    /** Heartbeat timeout -- 3 missed pings (90s). */
+    readonly HEARTBEAT_TIMEOUT: 1001;
+    /** Invalid frame data from client. */
+    readonly UNSUPPORTED_DATA: 1003;
+    /** Unexpected server error. */
+    readonly INTERNAL_ERROR: 1011;
+    /** Server shutting down via SIGTERM. */
+    readonly SERVICE_RESTART: 1012;
+};
+export interface MessageFrame {
+    type: "message";
+    payload: MessageRecord;
+    timestamp: string;
+}
+export interface PeerConnectedFrame {
+    type: "peer_connected";
+    payload: {
+        peerId: string;
+        name: string;
+        project: string;
+    };
+    timestamp: string;
+}
+export interface PeerDisconnectedFrame {
+    type: "peer_disconnected";
+    payload: {
+        peerId: string;
+    };
+    timestamp: string;
+}
+export interface PeersSnapshotFrame {
+    type: "peers_snapshot";
+    payload: {
+        peers: PeerInfo[];
+    };
+    timestamp: string;
+}
+export interface QueuedMessagesFrame {
+    type: "queued_messages";
+    payload: {
+        messages: MessageRecord[];
+    };
+    timestamp: string;
+}
+export interface ErrorFrame {
+    type: "error";
+    payload: {
+        code: string;
+        message: string;
+    };
+    timestamp: string;
+}
+/**
+ * Discriminated union of all server-to-client WebSocket frame types.
+ * The `type` field acts as the discriminator for client-side dispatch.
+ */
+export type WsServerFrame = MessageFrame | PeerConnectedFrame | PeerDisconnectedFrame | PeersSnapshotFrame | QueuedMessagesFrame | ErrorFrame;
+//# sourceMappingURL=ws-frames.d.ts.map

package/dist/cloud/ws-frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-frames.d.ts","sourceRoot":"","sources":["../../src/cloud/ws-frames.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB,oCAAoC;;IAEpC,iDAAiD;;IAEjD,sCAAsC;;IAEtC,+BAA+B;;IAE/B,wCAAwC;;CAEhC,CAAC;AAMX,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,kBAAkB,GAClB,qBAAqB,GACrB,kBAAkB,GAClB,mBAAmB,GACnB,UAAU,CAAC"}

package/dist/cloud/ws-frames.js

@@ -0,0 +1,19 @@
+// Client-side duplicate of server/src/ws/frames.ts type definitions.
+// Keep in sync. Will move to @essentialai/cogent in Phase 7.
+/**
+ * WebSocket close codes for different disconnect scenarios.
+ * Uses standard RFC 6455 / IANA-registered codes.
+ */
+export const WsCloseCode = {
+    /** Clean client-initiated close. */
+    NORMAL_CLOSURE: 1000,
+    /** Heartbeat timeout -- 3 missed pings (90s). */
+    HEARTBEAT_TIMEOUT: 1001,
+    /** Invalid frame data from client. */
+    UNSUPPORTED_DATA: 1003,
+    /** Unexpected server error. */
+    INTERNAL_ERROR: 1011,
+    /** Server shutting down via SIGTERM. */
+    SERVICE_RESTART: 1012,
+};
+//# sourceMappingURL=ws-frames.js.map

package/dist/cloud/ws-frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-frames.js","sourceRoot":"","sources":["../../src/cloud/ws-frames.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,6DAA6D;AAI7D;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,oCAAoC;IACpC,cAAc,EAAE,IAAI;IACpB,iDAAiD;IACjD,iBAAiB,EAAE,IAAI;IACvB,sCAAsC;IACtC,gBAAgB,EAAE,IAAI;IACtB,+BAA+B;IAC/B,cAAc,EAAE,IAAI;IACpB,wCAAwC;IACxC,eAAe,EAAE,IAAI;CACb,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,40 @@
+import { z } from "zod";
+export declare const configSchema: z.ZodObject<{
+    COGENT_STATE_PATH: z.ZodDefault<z.ZodString>;
+    COGENT_ENDPOINT: z.ZodOptional<z.ZodString>;
+    COGENT_SESSION_ID: z.ZodOptional<z.ZodString>;
+    COGENT_SECRET: z.ZodOptional<z.ZodString>;
+    COGENT_POLL_INTERVAL_MS: z.ZodDefault<z.ZodNumber>;
+    COGENT_TIMEOUT_MS: z.ZodDefault<z.ZodNumber>;
+    COGENT_CHAR_LIMIT: z.ZodDefault<z.ZodNumber>;
+    COGENT_LOG_LEVEL: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+    COGENT_CLAUDE_PATH: z.ZodDefault<z.ZodString>;
+    COGENT_STALE_TIMEOUT_MS: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    COGENT_STATE_PATH: string;
+    COGENT_POLL_INTERVAL_MS: number;
+    COGENT_TIMEOUT_MS: number;
+    COGENT_CHAR_LIMIT: number;
+    COGENT_LOG_LEVEL: "info" | "debug" | "warn" | "error";
+    COGENT_CLAUDE_PATH: string;
+    COGENT_STALE_TIMEOUT_MS: number;
+    COGENT_ENDPOINT?: string | undefined;
+    COGENT_SESSION_ID?: string | undefined;
+    COGENT_SECRET?: string | undefined;
+}, {
+    COGENT_STATE_PATH?: string | undefined;
+    COGENT_ENDPOINT?: string | undefined;
+    COGENT_SESSION_ID?: string | undefined;
+    COGENT_SECRET?: string | undefined;
+    COGENT_POLL_INTERVAL_MS?: number | undefined;
+    COGENT_TIMEOUT_MS?: number | undefined;
+    COGENT_CHAR_LIMIT?: number | undefined;
+    COGENT_LOG_LEVEL?: "info" | "debug" | "warn" | "error" | undefined;
+    COGENT_CLAUDE_PATH?: string | undefined;
+    COGENT_STALE_TIMEOUT_MS?: number | undefined;
+}>;
+export type Config = z.infer<typeof configSchema>;
+export declare function loadConfig(env?: Record<string, string | undefined>): Config;
+export declare function getConfig(): Config;
+export declare function resetConfig(): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAavB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAIlD,wBAAgB,UAAU,CACxB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,MAAM,CAUR;AAED,wBAAgB,SAAS,IAAI,MAAM,CAGlC;AAED,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/config.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import os from "node:os";
+import path from "node:path";
+const defaultStatePath = path.join(os.homedir(), ".cogent");
+export const configSchema = z.object({
+    COGENT_STATE_PATH: z.string().default(defaultStatePath),
+    COGENT_ENDPOINT: z.string().optional(),
+    COGENT_SESSION_ID: z.string().optional(),
+    COGENT_SECRET: z.string().optional(),
+    COGENT_POLL_INTERVAL_MS: z.coerce.number().int().min(1000).default(5000),
+    COGENT_TIMEOUT_MS: z.coerce.number().int().min(1000).default(120_000),
+    COGENT_CHAR_LIMIT: z.coerce.number().int().min(0).default(0),
+    COGENT_LOG_LEVEL: z
+        .enum(["debug", "info", "warn", "error"])
+        .default("info"),
+    COGENT_CLAUDE_PATH: z.string().default("claude"),
+    COGENT_STALE_TIMEOUT_MS: z.coerce.number().int().min(0).default(1_800_000),
+});
+let _config = null;
+export function loadConfig(env = process.env) {
+    const result = configSchema.safeParse(env);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Invalid configuration:\n${issues}`);
+    }
+    _config = Object.freeze(result.data);
+    return _config;
+}
+export function getConfig() {
+    if (!_config)
+        throw new Error("Config not loaded. Call loadConfig() first.");
+    return _config;
+}
+export function resetConfig() {
+    _config = null;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACvD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,uBAAuB,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACxE,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACrE,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,gBAAgB,EAAE,CAAC;SAChB,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;SACxC,OAAO,CAAC,MAAM,CAAC;IAClB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;IAChD,uBAAuB,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CAC3E,CAAC,CAAC;AAIH,IAAI,OAAO,GAAkB,IAAI,CAAC;AAElC,MAAM,UAAU,UAAU,CACxB,MAA0C,OAAO,CAAC,GAAG;IAErD,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aACjD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC7E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}