@agentstage/bridge 0.1.0

package/counter/store.json

@@ -0,0 +1,8 @@
+{
+  "state": {
+    "count": 5
+  },
+  "version": 1,
+  "updatedAt": "2026-02-17T11:10:58.002Z",
+  "pageId": "counter"
+}

package/dist/browser/createBridgeStore.d.ts

@@ -0,0 +1,5 @@
+import type { CreateBridgeStoreOptions, BridgeStore } from './types.js';
+export declare function createBridgeStore<TState, TActions extends Record<string, {
+    payload?: unknown;
+}> = Record<string, never>>(options: CreateBridgeStoreOptions<TState, TActions>): BridgeStore<TState>;
+//# sourceMappingURL=createBridgeStore.d.ts.map

package/dist/browser/createBridgeStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBridgeStore.d.ts","sourceRoot":"","sources":["../../src/browser/createBridgeStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkBxE,wBAAgB,iBAAiB,CAC/B,MAAM,EACN,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAE9E,OAAO,EAAE,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,GAClD,WAAW,CAAC,MAAM,CAAC,CA0PrB"}

package/dist/browser/createBridgeStore.js

@@ -0,0 +1,232 @@
+import { createStore } from 'zustand/vanilla';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+const WS_PATH = '/_bridge';
+function generateStoreId(pageId) {
+    const random = Math.random().toString(36).substring(2, 10);
+    return `${pageId}#${random}`;
+}
+function getGatewayUrl() {
+    if (typeof window === 'undefined') {
+        return '';
+    }
+    const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
+    return `${protocol}//${window.location.host}${WS_PATH}?type=browser`;
+}
+export function createBridgeStore(options) {
+    const gatewayUrl = options.gatewayUrl;
+    const storeKey = options.storeKey || 'main';
+    const storeId = generateStoreId(options.pageId);
+    const store = createStore((set, get) => options.createState((fn) => set(fn(get())), get));
+    const description = {
+        pageId: options.pageId,
+        storeKey,
+        schema: zodToJsonSchema(options.description.schema, { name: 'State' }),
+        actions: Object.fromEntries(Object.entries(options.description.actions).map(([key, def]) => [
+            key,
+            {
+                description: def.description,
+                payload: def.payload
+                    ? zodToJsonSchema(def.payload, { name: `${key}Payload` })
+                    : undefined,
+            },
+        ])),
+        events: options.description.events
+            ? Object.fromEntries(Object.entries(options.description.events).map(([key, def]) => [
+                key,
+                {
+                    description: def.description,
+                    payload: def.payload
+                        ? zodToJsonSchema(def.payload, { name: `${key}Payload` })
+                        : undefined,
+                },
+            ]))
+            : undefined,
+    };
+    let ws = null;
+    let version = 0;
+    let isConnected = false;
+    let isHydrated = false;
+    let resolveHydration = null;
+    let hydrationPromise = null;
+    let heartbeatInterval = null;
+    let suppressNextPublish = false;
+    function send(message) {
+        if (ws?.readyState === WebSocket.OPEN) {
+            ws.send(JSON.stringify(message));
+        }
+    }
+    function startHeartbeat() {
+        heartbeatInterval = setInterval(() => {
+            send({ type: 'store.heartbeat' });
+        }, 30000);
+    }
+    function stopHeartbeat() {
+        if (heartbeatInterval) {
+            clearInterval(heartbeatInterval);
+            heartbeatInterval = null;
+        }
+    }
+    function handleGatewayMessage(data) {
+        try {
+            const msg = JSON.parse(data);
+            switch (msg.type) {
+                case 'client.setState': {
+                    const { state, expectedVersion, requestId, version: targetVersion } = msg.payload;
+                    const canAck = typeof requestId === 'string' && requestId.length > 0;
+                    if (expectedVersion !== undefined && expectedVersion !== version) {
+                        if (canAck) {
+                            send({
+                                type: 'store.stateApplied',
+                                payload: {
+                                    storeId,
+                                    requestId,
+                                    status: 'version_mismatch',
+                                    version,
+                                },
+                            });
+                        }
+                        return;
+                    }
+                    try {
+                        suppressNextPublish = true;
+                        store.setState(state);
+                        if (typeof targetVersion === 'number') {
+                            version = targetVersion;
+                        }
+                        if (canAck) {
+                            send({
+                                type: 'store.stateApplied',
+                                payload: {
+                                    storeId,
+                                    requestId,
+                                    status: 'applied',
+                                    version,
+                                },
+                            });
+                        }
+                    }
+                    catch (error) {
+                        if (canAck) {
+                            send({
+                                type: 'store.stateApplied',
+                                payload: {
+                                    storeId,
+                                    requestId,
+                                    status: 'failed',
+                                    version,
+                                    error: error instanceof Error ? error.message : String(error),
+                                },
+                            });
+                        }
+                    }
+                    // Mark as hydrated on first setState
+                    if (!isHydrated) {
+                        isHydrated = true;
+                        resolveHydration?.();
+                    }
+                    break;
+                }
+                case 'client.dispatch': {
+                    const { action } = msg.payload;
+                    const current = store.getState();
+                    if (typeof current.dispatch === 'function') {
+                        current.dispatch(action);
+                    }
+                    break;
+                }
+                case 'client.ping':
+                    break;
+            }
+        }
+        catch (err) {
+            console.error('[BridgeStore] Failed to handle message:', err);
+        }
+    }
+    const unsubscribe = store.subscribe((state) => {
+        if (suppressNextPublish) {
+            suppressNextPublish = false;
+            return;
+        }
+        version += 1;
+        send({
+            type: 'store.stateChanged',
+            payload: {
+                storeId,
+                state,
+                version,
+                source: 'browser',
+            },
+        });
+    });
+    return {
+        store,
+        describes() {
+            return description;
+        },
+        get isConnected() {
+            return isConnected;
+        },
+        get isHydrated() {
+            return isHydrated;
+        },
+        connect() {
+            return new Promise((resolve, reject) => {
+                if (ws?.readyState === WebSocket.OPEN) {
+                    resolve({ storeId, disconnect: () => ws?.close() });
+                    return;
+                }
+                const url = gatewayUrl || getGatewayUrl();
+                if (!url) {
+                    reject(new Error('Cannot connect: gatewayUrl not provided and window is not available'));
+                    return;
+                }
+                ws = new WebSocket(url);
+                ws.onopen = () => {
+                    isConnected = true;
+                    // Create hydration promise - resolves when first client.setState arrives
+                    hydrationPromise = new Promise((resolveHydrationFn) => {
+                        resolveHydration = resolveHydrationFn;
+                    });
+                    send({
+                        type: 'store.register',
+                        payload: {
+                            storeId,
+                            pageId: options.pageId,
+                            storeKey,
+                            description,
+                            initialState: store.getState(),
+                        },
+                    });
+                    startHeartbeat();
+                };
+                // Wait for hydration before resolving connect()
+                const checkHydration = async () => {
+                    if (hydrationPromise) {
+                        await hydrationPromise;
+                    }
+                    resolve({
+                        storeId,
+                        disconnect: () => {
+                            send({ type: 'store.disconnect' });
+                            stopHeartbeat();
+                            unsubscribe();
+                            ws?.close();
+                        },
+                    });
+                };
+                checkHydration();
+                ws.onmessage = (event) => {
+                    handleGatewayMessage(event.data);
+                };
+                ws.onclose = () => {
+                    isConnected = false;
+                    stopHeartbeat();
+                };
+                ws.onerror = (err) => {
+                    reject(err);
+                };
+            });
+        },
+    };
+}
+//# sourceMappingURL=createBridgeStore.js.map

package/dist/browser/createBridgeStore.js.map

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

package/dist/browser/index.d.ts

@@ -0,0 +1,4 @@
+export { createBridgeStore } from './createBridgeStore.js';
+export type { CreateBridgeStoreOptions, BridgeStore, } from './types.js';
+export type { StoreDescription, StoreState } from '../shared/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,wBAAwB,EACxB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,2 @@
+export { createBridgeStore } from './createBridgeStore.js';
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/browser/types.d.ts

@@ -0,0 +1,36 @@
+import type { StoreApi } from 'zustand/vanilla';
+import type { ZodSchema } from 'zod';
+import type { StoreDescription, StoreState } from '../shared/types.js';
+export interface CreateBridgeStoreOptions<TState, TActions extends Record<string, {
+    payload?: unknown;
+}>> {
+    gatewayUrl?: string;
+    pageId: string;
+    storeKey?: string;
+    description: {
+        schema: ZodSchema<TState>;
+        actions: {
+            [K in keyof TActions]: {
+                description: string;
+                payload?: ZodSchema<TActions[K]['payload']>;
+            };
+        };
+        events?: Record<string, {
+            description: string;
+            payload?: ZodSchema<unknown>;
+        }>;
+    };
+    createState: (set: (fn: (state: TState) => Partial<TState>) => void, get: () => TState) => TState;
+}
+export interface BridgeStore<TState> {
+    readonly store: StoreApi<TState>;
+    describes(): StoreDescription;
+    connect(): Promise<{
+        storeId: string;
+        disconnect: () => void;
+    }>;
+    readonly isConnected: boolean;
+    readonly isHydrated: boolean;
+}
+export type { StoreDescription, StoreState };
+//# sourceMappingURL=types.d.ts.map

package/dist/browser/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/browser/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEvE,MAAM,WAAW,wBAAwB,CACvC,MAAM,EACN,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;IAEtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE;QACX,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,EAAE;aACN,CAAC,IAAI,MAAM,QAAQ,GAAG;gBACrB,WAAW,EAAE,MAAM,CAAC;gBACpB,OAAO,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;aAC7C;SACF,CAAC;QACF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;SAAE,CAAC,CAAC;KAChF,CAAC;IACF,WAAW,EAAE,CACX,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EACrD,GAAG,EAAE,MAAM,MAAM,KACd,MAAM,CAAC;CACb;AAED,MAAM,WAAW,WAAW,CAAC,MAAM;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,IAAI,gBAAgB,CAAC;IAC9B,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC"}

package/dist/browser/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/browser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/browser/types.ts"],"names":[],"mappings":""}

package/dist/gateway/apiHandler.d.ts

@@ -0,0 +1,10 @@
+import type { Gateway } from './types.js';
+export declare function createBridgeApiHandler(gateway: Gateway): {
+    GET: ({ request }: {
+        request: Request;
+    }) => Promise<Response>;
+    POST: ({ request }: {
+        request: Request;
+    }) => Promise<Response>;
+};
+//# sourceMappingURL=apiHandler.d.ts.map

package/dist/gateway/apiHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiHandler.d.ts","sourceRoot":"","sources":["../../src/gateway/apiHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO;uBAE1B;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE;wBA4DnB;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE;EA0CjD"}

package/dist/gateway/apiHandler.js

@@ -0,0 +1,91 @@
+export function createBridgeApiHandler(gateway) {
+    return {
+        GET: async ({ request }) => {
+            const url = new URL(request.url);
+            const path = url.pathname.replace('/api/bridge', '').split('/').filter(Boolean);
+            if (path.length === 1 && path[0] === 'stores') {
+                return Response.json({ stores: gateway.listStores() });
+            }
+            if (path.length === 2 && path[0] === 'stores') {
+                const storeId = path[1];
+                const store = gateway.getStore(storeId);
+                if (!store) {
+                    return new Response(JSON.stringify({ error: 'Store not found' }), {
+                        status: 404,
+                        headers: { 'Content-Type': 'application/json' }
+                    });
+                }
+                return Response.json({
+                    id: store.id,
+                    pageId: store.pageId,
+                    storeKey: store.storeKey,
+                    description: store.description,
+                    version: store.version,
+                    connectedAt: store.connectedAt,
+                    lastActivity: store.lastActivity,
+                });
+            }
+            if (path.length === 3 && path[0] === 'stores' && path[2] === 'state') {
+                const storeId = path[1];
+                const state = gateway.getState(storeId);
+                if (!state) {
+                    return new Response(JSON.stringify({ error: 'Store not found' }), {
+                        status: 404,
+                        headers: { 'Content-Type': 'application/json' }
+                    });
+                }
+                return Response.json(state);
+            }
+            if (path.length === 3 && path[0] === 'pages' && path[2] === 'stores') {
+                const pageId = path[1];
+                const stores = gateway.stores;
+                const pageStores = Array.from(stores.values())
+                    .filter(s => s.pageId === pageId)
+                    .map(s => ({
+                    id: s.id,
+                    storeKey: s.storeKey,
+                    version: s.version,
+                    connectedAt: s.connectedAt,
+                }));
+                return Response.json({ stores: pageStores });
+            }
+            return new Response(JSON.stringify({ error: 'Not found' }), {
+                status: 404,
+                headers: { 'Content-Type': 'application/json' }
+            });
+        },
+        POST: async ({ request }) => {
+            const url = new URL(request.url);
+            const path = url.pathname.replace('/api/bridge', '').split('/').filter(Boolean);
+            if (path.length === 3 && path[0] === 'stores' && path[2] === 'state') {
+                const storeId = path[1];
+                const body = await request.json();
+                try {
+                    await gateway.setState(storeId, body.state, {
+                        expectedVersion: body.expectedVersion
+                    });
+                    return Response.json({ ok: true });
+                }
+                catch (err) {
+                    return new Response(JSON.stringify({ error: err instanceof Error ? err.message : 'Failed to set state' }), { status: 500, headers: { 'Content-Type': 'application/json' } });
+                }
+            }
+            if (path.length === 3 && path[0] === 'stores' && path[2] === 'dispatch') {
+                const storeId = path[1];
+                const body = await request.json();
+                try {
+                    await gateway.dispatch(storeId, body.action);
+                    return Response.json({ ok: true });
+                }
+                catch (err) {
+                    return new Response(JSON.stringify({ error: err instanceof Error ? err.message : 'Failed to dispatch' }), { status: 500, headers: { 'Content-Type': 'application/json' } });
+                }
+            }
+            return new Response(JSON.stringify({ error: 'Not found' }), {
+                status: 404,
+                headers: { 'Content-Type': 'application/json' }
+            });
+        },
+    };
+}
+//# sourceMappingURL=apiHandler.js.map

package/dist/gateway/apiHandler.js.map

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

package/dist/gateway/createBridgeGateway.d.ts

@@ -0,0 +1,3 @@
+import type { Gateway, GatewayOptions } from './types.js';
+export declare function createBridgeGateway(options?: GatewayOptions): Gateway;
+//# sourceMappingURL=createBridgeGateway.d.ts.map

package/dist/gateway/createBridgeGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createBridgeGateway.d.ts","sourceRoot":"","sources":["../../src/gateway/createBridgeGateway.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EAMf,MAAM,YAAY,CAAC;AAkBpB,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAwzBzE"}