@nority/bridge-sdk 0.1.0

package/dist/bridge.d.ts

@@ -0,0 +1,44 @@
+import type { BridgeConfig, PairingInfo } from "./agent.js";
+import type { ProactiveTurnRequest } from "./runtime/proactive.js";
+import { type BridgeFrame } from "./protocol/frames.js";
+/**
+ * Bridge lifecycle states.
+ */
+export type BridgeState = "idle" | "pairing" | "connecting" | "connected" | "reconnecting" | "blocked" | "failed" | "stopped";
+/**
+ * NorityBridge is the main entry point for bridge implementations.
+ * Manages pairing, auth refresh, reconnection, and durable bridge identity.
+ */
+export declare class NorityBridge {
+    private readonly config;
+    private readonly logger;
+    private readonly stateStore;
+    private readonly accessTokenManager;
+    private readonly conversationRuntime;
+    private state;
+    private durableState;
+    private pairingInfo;
+    private pairingTimer;
+    private pairingSocket;
+    private transport;
+    private readonly pendingFrameTasks;
+    constructor(config: BridgeConfig);
+    getState(): BridgeState;
+    getPairingInfo(): PairingInfo | null;
+    createProactiveTurnFrame(conversationId: string, request: ProactiveTurnRequest): BridgeFrame<"assistant_turn_start">;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    regeneratePairingToken(): Promise<PairingInfo>;
+    private beginPairingFlow;
+    private restartPairingFlow;
+    private handlePairingMessage;
+    private ensureAuthenticatedTransport;
+    private handleTransportStateChange;
+    private getDurableState;
+    private clearPairingTimer;
+    private setState;
+    private handleTransportFrame;
+    private trackFrameTask;
+    private sendTransportFrame;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAgB,WAAW,EAAE,MAAM,YAAY,CAAC;AAW1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAMnE,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGrE;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,SAAS,GACT,YAAY,GACZ,WAAW,GACX,cAAc,GACd,SAAS,GACT,QAAQ,GACR,SAAS,CAAC;AASd;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAC9D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,SAAS,CAAgD;IACjE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;gBAElD,MAAM,EAAE,YAAY;IAkBhC,QAAQ,IAAI,WAAW;IAIvB,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC,wBAAwB,CACtB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,oBAAoB,GAC5B,WAAW,CAAC,sBAAsB,CAAC;IAOhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBrB,sBAAsB,IAAI,OAAO,CAAC,WAAW,CAAC;YAatC,gBAAgB;YAKhB,kBAAkB;YAkDlB,oBAAoB;YAuDpB,4BAA4B;IAqC1C,OAAO,CAAC,0BAA0B;IAqClC,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,QAAQ;YAIF,oBAAoB;YAYpB,cAAc;IAS5B,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/bridge.js

@@ -0,0 +1,311 @@
+import { validateConfig } from "./config.js";
+import { createPairingExpiry, createPairingToken, createDeeplinkUrl, PAIRING_TOKEN_TTL_SECONDS, } from "./auth/pairing.js";
+import { BridgeAccessTokenManager } from "./auth/reconnect.js";
+import { FileBridgeStateStore } from "./storage/state-store.js";
+import { ConversationRuntime } from "./conversation/runtime.js";
+import { AuthenticatedWebSocketTransport, } from "./transport/websocket.js";
+import { createFrame } from "./protocol/frames.js";
+import { getEd25519PublicKeyBase64 } from "./crypto/identity.js";
+const noopLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/**
+ * NorityBridge is the main entry point for bridge implementations.
+ * Manages pairing, auth refresh, reconnection, and durable bridge identity.
+ */
+export class NorityBridge {
+    config;
+    logger;
+    stateStore;
+    accessTokenManager;
+    conversationRuntime;
+    state = "idle";
+    durableState = null;
+    pairingInfo = null;
+    pairingTimer = null;
+    pairingSocket = null;
+    transport = null;
+    pendingFrameTasks = new Set();
+    constructor(config) {
+        validateConfig(config);
+        this.config = config;
+        this.logger = config.logger ?? noopLogger;
+        this.stateStore = new FileBridgeStateStore(config.dataDir);
+        this.accessTokenManager = new BridgeAccessTokenManager({
+            backendUrl: config.backendUrl,
+            fetchImplementation: config.fetchImplementation,
+            clock: config.clock,
+        });
+        this.conversationRuntime = new ConversationRuntime({
+            dataDir: config.dataDir,
+            agent: config.agent,
+            logger: this.logger,
+            clock: config.clock,
+        });
+    }
+    getState() {
+        return this.state;
+    }
+    getPairingInfo() {
+        return this.pairingInfo === null ? null : { ...this.pairingInfo };
+    }
+    createProactiveTurnFrame(conversationId, request) {
+        return this.conversationRuntime.createProactiveTurnFrame(conversationId, request);
+    }
+    async start() {
+        if (this.state !== "idle" && this.state !== "stopped") {
+            throw new Error(`NorityBridge.start: cannot start bridge in state ${this.state}`);
+        }
+        this.durableState = await this.stateStore.loadOrCreateIdentity();
+        await this.conversationRuntime.loadPersistedConversations();
+        if (!this.durableState.bridgeCredential) {
+            this.setState("pairing");
+            await this.beginPairingFlow();
+            return;
+        }
+        await this.ensureAuthenticatedTransport(false);
+    }
+    async stop() {
+        this.clearPairingTimer();
+        const pairingSocket = this.pairingSocket;
+        this.pairingSocket = null;
+        if (pairingSocket !== null) {
+            pairingSocket.close(1000, "pairing stopped");
+        }
+        this.conversationRuntime.stop();
+        if (this.transport !== null) {
+            await this.transport.disconnect();
+            this.transport = null;
+        }
+        await Promise.allSettled(Array.from(this.pendingFrameTasks));
+        this.setState("stopped");
+    }
+    async regeneratePairingToken() {
+        if (this.state !== "pairing") {
+            throw new Error(`NorityBridge.regeneratePairingToken: bridge must be in pairing state, got ${this.state}`);
+        }
+        await this.restartPairingFlow();
+        if (this.pairingInfo === null) {
+            throw new Error("NorityBridge.regeneratePairingToken: pairingInfo must exist");
+        }
+        return { ...this.pairingInfo };
+    }
+    async beginPairingFlow() {
+        const currentState = this.getDurableState();
+        await this.restartPairingFlow(currentState);
+    }
+    async restartPairingFlow(state = this.getDurableState()) {
+        const existingSocket = this.pairingSocket;
+        this.pairingSocket = null;
+        if (existingSocket !== null) {
+            existingSocket.close(1000, "pairing token rotated");
+        }
+        this.clearPairingTimer();
+        const token = this.config.pairingTokenFactory?.() ?? createPairingToken();
+        if (!token) {
+            throw new Error("NorityBridge.restartPairingFlow: pairing token must not be empty");
+        }
+        this.pairingInfo = {
+            token,
+            deeplinkUrl: createDeeplinkUrl(token),
+            expiresAt: createPairingExpiry({
+                clock: this.config.clock,
+                tokenTtlSeconds: PAIRING_TOKEN_TTL_SECONDS,
+            }),
+        };
+        this.config.onPairingToken?.({ ...this.pairingInfo });
+        this.pairingTimer = setTimeout(() => {
+            void this.restartPairingFlow(state);
+        }, PAIRING_TOKEN_TTL_SECONDS * 1000);
+        const webSocketFactory = this.config.webSocketFactory;
+        if (webSocketFactory === undefined) {
+            throw new Error("NorityBridge.restartPairingFlow: webSocketFactory is required for pairing");
+        }
+        const socket = webSocketFactory.create(this.config.backendUrl, {});
+        this.pairingSocket = socket;
+        await waitForOpen(socket);
+        socket.addEventListener("message", (event) => {
+            void this.handlePairingMessage(event.data);
+        });
+        const pairRequest = createFrame("pair_request", {
+            pairing_token: token,
+            bridge_public_key: getEd25519PublicKeyBase64(state.publicKeyPem),
+        });
+        socket.send(JSON.stringify(pairRequest));
+    }
+    async handlePairingMessage(rawData) {
+        let frame;
+        try {
+            frame = JSON.parse(rawData);
+        }
+        catch (error) {
+            this.logger.warn("NorityBridge.handlePairingMessage: invalid JSON", error);
+            return;
+        }
+        if (frame.type !== "paired") {
+            return;
+        }
+        const payload = frame.payload;
+        if (!payload.agent_id ||
+            !payload.bridge_credential ||
+            !payload.access_jwt ||
+            !payload.expires_at) {
+            throw new Error("NorityBridge.handlePairingMessage: paired payload missing required fields");
+        }
+        const currentState = this.getDurableState();
+        const nextState = {
+            ...currentState,
+            agentId: payload.agent_id,
+            bridgeCredential: payload.bridge_credential,
+        };
+        await this.stateStore.save(nextState);
+        this.durableState = nextState;
+        this.accessTokenManager.seed({
+            accessJwt: payload.access_jwt,
+            agentId: payload.agent_id,
+            expiresAt: payload.expires_at,
+        });
+        this.clearPairingTimer();
+        const pairingSocket = this.pairingSocket;
+        this.pairingSocket = null;
+        if (pairingSocket !== null) {
+            pairingSocket.close(1000, "pairing completed");
+        }
+        await this.ensureAuthenticatedTransport(false);
+    }
+    async ensureAuthenticatedTransport(forceRefresh) {
+        const currentState = this.getDurableState();
+        if (!currentState.bridgeCredential) {
+            throw new Error("NorityBridge.ensureAuthenticatedTransport: bridgeCredential is required");
+        }
+        if (this.transport === null) {
+            this.transport = new AuthenticatedWebSocketTransport({
+                backendUrl: this.config.backendUrl,
+                webSocketFactory: this.config.webSocketFactory,
+                heartbeatIntervalMs: this.config.heartbeatIntervalMs,
+                idleTimeoutMs: this.config.idleTimeoutMs,
+                random: this.config.backoffRandom,
+                clock: this.config.clock,
+                logger: this.logger,
+                onFrame: async (frame) => {
+                    await this.trackFrameTask(this.handleTransportFrame(frame));
+                },
+                onStateChange: (transportState) => {
+                    this.handleTransportStateChange(transportState);
+                },
+                getAccessToken: async (refreshRequested = false) => {
+                    const token = await this.accessTokenManager.getAccessToken({
+                        credential: currentState.bridgeCredential ?? "",
+                        privateKeyPem: currentState.privateKeyPem,
+                        forceRefresh: refreshRequested,
+                    });
+                    return token.accessJwt;
+                },
+            });
+        }
+        await this.transport.connect(forceRefresh);
+    }
+    handleTransportStateChange(transportState) {
+        switch (transportState) {
+            case "connecting":
+                this.setState("connecting");
+                break;
+            case "connected":
+                this.setState("connected");
+                if (this.transport !== null) {
+                    const replayRequest = this.conversationRuntime.createReplayRequestFrame();
+                    if (replayRequest !== null) {
+                        this.transport.send(replayRequest);
+                    }
+                }
+                break;
+            case "reconnecting":
+                this.setState("reconnecting");
+                break;
+            case "blocked":
+                this.setState("blocked");
+                break;
+            case "failed":
+                this.setState("failed");
+                break;
+            case "stopped":
+                if (this.state !== "stopped") {
+                    this.setState("stopped");
+                }
+                break;
+            case "idle":
+                break;
+            default:
+                throw new Error(`NorityBridge.handleTransportStateChange: unsupported transport state ${transportState}`);
+        }
+    }
+    getDurableState() {
+        if (this.durableState === null) {
+            throw new Error("NorityBridge: durable bridge state has not been loaded");
+        }
+        return this.durableState;
+    }
+    clearPairingTimer() {
+        if (this.pairingTimer !== null) {
+            clearTimeout(this.pairingTimer);
+            this.pairingTimer = null;
+        }
+    }
+    setState(nextState) {
+        this.state = nextState;
+    }
+    async handleTransportFrame(frame) {
+        if (this.transport === null) {
+            throw new Error("NorityBridge.handleTransportFrame: transport must exist while handling frames");
+        }
+        await this.conversationRuntime.handleFrame(frame, (outboundFrame) => {
+            this.sendTransportFrame(outboundFrame);
+        });
+    }
+    async trackFrameTask(task) {
+        this.pendingFrameTasks.add(task);
+        try {
+            await task;
+        }
+        finally {
+            this.pendingFrameTasks.delete(task);
+        }
+    }
+    sendTransportFrame(outboundFrame) {
+        if (this.transport === null) {
+            throw new Error("NorityBridge.sendTransportFrame: transport must exist while sending outbound frames");
+        }
+        this.transport.send(outboundFrame);
+    }
+}
+function waitForOpen(socket) {
+    if (socket.readyState === 1) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve, reject) => {
+        const handleOpen = () => {
+            cleanup();
+            resolve();
+        };
+        const handleError = () => {
+            cleanup();
+            reject(new Error("NorityBridge.waitForOpen: websocket error during pairing"));
+        };
+        const handleClose = () => {
+            cleanup();
+            reject(new Error("NorityBridge.waitForOpen: websocket closed before pairing socket opened"));
+        };
+        const cleanup = () => {
+            socket.removeEventListener("open", handleOpen);
+            socket.removeEventListener("error", handleError);
+            socket.removeEventListener("close", handleClose);
+        };
+        socket.addEventListener("open", handleOpen);
+        socket.addEventListener("error", handleError);
+        socket.addEventListener("close", handleClose);
+    });
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+import type { BridgeConfig } from "./agent.js";
+/**
+ * Validate bridge configuration at startup.
+ */
+export declare function validateConfig(config: BridgeConfig): 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,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAmEzD"}

package/dist/config.js

@@ -0,0 +1,47 @@
+/**
+ * Validate bridge configuration at startup.
+ */
+export function validateConfig(config) {
+    if (!config) {
+        throw new Error("validateConfig: config is required");
+    }
+    if (!config.backendUrl) {
+        throw new Error("validateConfig: backendUrl is required");
+    }
+    if (!config.dataDir) {
+        throw new Error("validateConfig: dataDir is required");
+    }
+    if (!config.agent) {
+        throw new Error("validateConfig: agent adapter is required");
+    }
+    if (typeof config.agent.invokeAgent !== "function") {
+        throw new Error("validateConfig: agent must implement invokeAgent()");
+    }
+    try {
+        new URL(config.backendUrl);
+    }
+    catch {
+        throw new Error(`validateConfig: backendUrl is not a valid URL: ${config.backendUrl}`);
+    }
+    if (config.heartbeatIntervalMs !== undefined &&
+        (!Number.isInteger(config.heartbeatIntervalMs) || config.heartbeatIntervalMs <= 0)) {
+        throw new Error(`validateConfig: heartbeatIntervalMs must be a positive integer, got ${config.heartbeatIntervalMs}`);
+    }
+    if (config.idleTimeoutMs !== undefined &&
+        (!Number.isInteger(config.idleTimeoutMs) || config.idleTimeoutMs <= 0)) {
+        throw new Error(`validateConfig: idleTimeoutMs must be a positive integer, got ${config.idleTimeoutMs}`);
+    }
+    if (config.heartbeatIntervalMs !== undefined &&
+        config.idleTimeoutMs !== undefined &&
+        config.idleTimeoutMs <= config.heartbeatIntervalMs) {
+        throw new Error("validateConfig: idleTimeoutMs must be greater than heartbeatIntervalMs");
+    }
+    if (config.pairingTokenFactory !== undefined &&
+        typeof config.pairingTokenFactory !== "function") {
+        throw new Error("validateConfig: pairingTokenFactory must be a function when provided");
+    }
+    if (config.webSocketFactory !== undefined && typeof config.webSocketFactory.create !== "function") {
+        throw new Error("validateConfig: webSocketFactory.create must be a function when provided");
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,kDAAkD,MAAM,CAAC,UAAU,EAAE,CACtE,CAAC;IACJ,CAAC;IAED,IACE,MAAM,CAAC,mBAAmB,KAAK,SAAS;QACxC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,MAAM,CAAC,mBAAmB,IAAI,CAAC,CAAC,EAClF,CAAC;QACD,MAAM,IAAI,KAAK,CACb,uEAAuE,MAAM,CAAC,mBAAmB,EAAE,CACpG,CAAC;IACJ,CAAC;IAED,IACE,MAAM,CAAC,aAAa,KAAK,SAAS;QAClC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC,EACtE,CAAC;QACD,MAAM,IAAI,KAAK,CACb,iEAAiE,MAAM,CAAC,aAAa,EAAE,CACxF,CAAC;IACJ,CAAC;IAED,IACE,MAAM,CAAC,mBAAmB,KAAK,SAAS;QACxC,MAAM,CAAC,aAAa,KAAK,SAAS;QAClC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,mBAAmB,EAClD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;IACJ,CAAC;IAED,IACE,MAAM,CAAC,mBAAmB,KAAK,SAAS;QACxC,OAAO,MAAM,CAAC,mBAAmB,KAAK,UAAU,EAChD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,gBAAgB,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,gBAAgB,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAClG,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/conversation/replay.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Replay and history rebuild logic following the bridge protocol specification.
+ *
+ * Rules (from bridge-protocol/replay/):
+ * 1. Skip events at or below last_applied_seq
+ * 2. Deduplicate by seq (first occurrence wins)
+ * 3. Sort remaining by ascending seq
+ * 4. Apply events in order to rebuild history
+ *
+ * Event format matches what the bridge SDK encrypts and stores:
+ * { type: "text_delta", content: "...", message_id: "..." }
+ */
+export interface Turn {
+    role: "user" | "assistant";
+    text: string;
+    status: "complete" | "streaming";
+}
+export interface ConversationState {
+    last_applied_seq: number;
+    turns: Turn[];
+}
+export interface ReplayEvent {
+    seq: number;
+    type: string;
+    text?: string;
+    content?: string;
+    message_id?: string;
+}
+export declare function rebuildHistory(initialState: ConversationState, replayEvents: ReplayEvent[]): ConversationState;
+//# sourceMappingURL=replay.d.ts.map

package/dist/conversation/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/conversation/replay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,cAAc,CAC5B,YAAY,EAAE,iBAAiB,EAC/B,YAAY,EAAE,WAAW,EAAE,GAC1B,iBAAiB,CAgFnB"}

package/dist/conversation/replay.js

@@ -0,0 +1,85 @@
+/**
+ * Replay and history rebuild logic following the bridge protocol specification.
+ *
+ * Rules (from bridge-protocol/replay/):
+ * 1. Skip events at or below last_applied_seq
+ * 2. Deduplicate by seq (first occurrence wins)
+ * 3. Sort remaining by ascending seq
+ * 4. Apply events in order to rebuild history
+ *
+ * Event format matches what the bridge SDK encrypts and stores:
+ * { type: "text_delta", content: "...", message_id: "..." }
+ */
+export function rebuildHistory(initialState, replayEvents) {
+    if (!initialState) {
+        throw new Error("rebuildHistory: initialState is required");
+    }
+    if (!Array.isArray(replayEvents)) {
+        throw new Error("rebuildHistory: replayEvents must be an array");
+    }
+    // 1. Filter out events at or below last_applied_seq
+    const filtered = replayEvents.filter((e) => e.seq > initialState.last_applied_seq);
+    // 2. Deduplicate by seq (first occurrence wins)
+    const seen = new Set();
+    const deduped = [];
+    for (const event of filtered) {
+        if (!seen.has(event.seq)) {
+            seen.add(event.seq);
+            deduped.push(event);
+        }
+    }
+    // 3. Sort by ascending seq
+    deduped.sort((a, b) => a.seq - b.seq);
+    // 4. Apply events to rebuild state
+    const turns = [...initialState.turns.map((t) => ({ ...t }))];
+    let lastSeq = initialState.last_applied_seq;
+    // Track in-progress assistant messages
+    const pendingAssistant = new Map(); // message_id -> turn index
+    for (const event of deduped) {
+        lastSeq = event.seq;
+        switch (event.type) {
+            case "user_message": {
+                turns.push({
+                    role: "user",
+                    text: event.content ?? event.text ?? "",
+                    status: "complete",
+                });
+                break;
+            }
+            case "text_delta": {
+                const msgId = event.message_id ?? "";
+                const text = event.content ?? "";
+                if (!pendingAssistant.has(msgId)) {
+                    const idx = turns.length;
+                    turns.push({
+                        role: "assistant",
+                        text,
+                        status: "streaming",
+                    });
+                    pendingAssistant.set(msgId, idx);
+                }
+                else {
+                    const idx = pendingAssistant.get(msgId);
+                    turns[idx].text += text;
+                }
+                break;
+            }
+            case "done": {
+                const msgId = event.message_id ?? "";
+                if (pendingAssistant.has(msgId)) {
+                    const idx = pendingAssistant.get(msgId);
+                    turns[idx].status = "complete";
+                    pendingAssistant.delete(msgId);
+                }
+                break;
+            }
+            case "tool_call_start":
+            case "tool_result":
+            case "run_status":
+                // Acknowledged but not rendered in history turns.
+                break;
+        }
+    }
+    return { last_applied_seq: lastSeq, turns };
+}
+//# sourceMappingURL=replay.js.map

package/dist/conversation/replay.js.map

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

package/dist/conversation/runtime.d.ts

@@ -0,0 +1,43 @@
+import type { AgentAdapter, AgentEvent, BridgeLogger } from "../agent.js";
+import { type BridgeFrame } from "../protocol/frames.js";
+import { type ProactiveTurnRequest } from "../runtime/proactive.js";
+export interface ConversationRuntimeOptions {
+    dataDir: string;
+    agent: AgentAdapter;
+    logger?: BridgeLogger;
+    clock?: () => Date;
+}
+/**
+ * Conversation runtime for key exchange, encrypted message handling, replay, and deletion.
+ */
+export declare class ConversationRuntime {
+    private readonly agent;
+    private readonly logger;
+    private readonly clock;
+    private readonly store;
+    private readonly conversations;
+    private readonly activeInvocations;
+    constructor(options: ConversationRuntimeOptions);
+    loadPersistedConversations(): Promise<void>;
+    hasConversation(conversationId: string): boolean;
+    createReplayRequestFrame(): BridgeFrame<"replay_request"> | null;
+    createProactiveTurnFrame(conversationId: string, request: ProactiveTurnRequest): BridgeFrame<"assistant_turn_start">;
+    stop(): void;
+    private activeInvocationCount;
+    handleFrame(frame: BridgeFrame, sendFrame: (frame: BridgeFrame) => void): Promise<void>;
+    private handleKeyExchange;
+    private handleMessage;
+    private handleReplay;
+    private handleConversationDeleted;
+    private applyReplayEvents;
+    private applyReplayPayload;
+    private applyAssistantReplayDelta;
+    private completeAssistantReplayTurn;
+    private abortInvocation;
+}
+export type SerializedEventType = "text_delta" | "tool_call_start" | "tool_call_update" | "tool_result" | "thinking_start" | "thinking_delta" | "thinking_complete" | "run_status" | "error" | "done";
+export declare function serializeAgentEvent(event: AgentEvent): {
+    eventType: SerializedEventType;
+    body: Record<string, string>;
+} | null;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/conversation/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/conversation/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAyB,MAAM,aAAa,CAAC;AAajG,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AASD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAsC;gBAE5D,OAAO,EAAE,0BAA0B;IAiBzC,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjD,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAOhD,wBAAwB,IAAI,WAAW,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAahE,wBAAwB,CACtB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,oBAAoB,GAC5B,WAAW,CAAC,sBAAsB,CAAC;IAStC,IAAI,IAAI,IAAI;IAMZ,OAAO,CAAC,qBAAqB;IAIvB,WAAW,CACf,KAAK,EAAE,WAAW,EAClB,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC;YAgCF,iBAAiB;YAmCjB,aAAa;YA0Eb,YAAY;YAgDZ,yBAAyB;IAavC,OAAO,CAAC,iBAAiB;IAyBzB,OAAO,CAAC,kBAAkB;IAgD1B,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,2BAA2B;IAOnC,OAAO,CAAC,eAAe;CAIxB;AAoFD,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,iBAAiB,GACjB,kBAAkB,GAClB,aAAa,GACb,gBAAgB,GAChB,gBAAgB,GAChB,mBAAmB,GACnB,YAAY,GACZ,OAAO,GACP,MAAM,CAAC;AAEX,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,GAEf;IACE,SAAS,EAAE,mBAAmB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,GACD,IAAI,CAwFP"}