Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
import type { PreviewViewportSetting } from "@akeru/contracts";
type BrowserViewportHandler = (setting: PreviewViewportSetting) => Promise<void>;
export const BROWSER_VIEWPORT_COMMIT_TIMEOUT_MS = 15_000;
export class BrowserViewportCommitTimeoutError extends Error {
override readonly name = "BrowserViewportCommitTimeoutError";
constructor(readonly tabId: string) {
super(`Timed out committing the browser viewport for tab ${tabId}`);
}
}
const handlers = new Map<string, BrowserViewportHandler>();
const commitTails = new Map<string, Promise<void>>();
const queueBrowserViewportMutation = <A>(tabId: string, start: () => Promise<A>) => {
const previous = commitTails.get(tabId) ?? Promise.resolve();
const started = previous
.catch(() => undefined)
.then(() => ({
operation: Promise.resolve().then(start),
}));
const execution = started.then(({ operation }) => operation);
const tail = execution.then(() => undefined);
commitTails.set(tabId, tail);
const clear = () => {
if (commitTails.get(tabId) === tail) commitTails.delete(tabId);
};
void tail.then(clear, clear);
return { started, execution };
};
/**
* Serializes every server-side viewport mutation for one desktop runtime tab.
* Both visible UI commits and background automation use this queue so a
* compensating rollback cannot overtake a newer resize.
*/
export function runBrowserViewportMutation<A>(
tabId: string,
mutation: () => Promise<A>,
): Promise<A> {
return queueBrowserViewportMutation(tabId, mutation).execution;
}
const runHandlerWithTimeout = (tabId: string, operation: Promise<void>): Promise<void> => {
let timeoutId: ReturnType<typeof setTimeout> | undefined;
const timeout = new Promise<never>((_resolve, reject) => {
timeoutId = setTimeout(
() => reject(new BrowserViewportCommitTimeoutError(tabId)),
BROWSER_VIEWPORT_COMMIT_TIMEOUT_MS,
);
});
return Promise.race([operation, timeout]).finally(() => {
if (timeoutId !== undefined) clearTimeout(timeoutId);
});
};
export function subscribeBrowserViewportChange(
tabId: string,
handler: BrowserViewportHandler,
): () => void {
handlers.set(tabId, handler);
return () => {
if (handlers.get(tabId) === handler) handlers.delete(tabId);
};
}
export function commitBrowserViewportChange(
tabId: string,
setting: PreviewViewportSetting,
): Promise<void> {
const { started } = queueBrowserViewportMutation(tabId, () => {
const handler = handlers.get(tabId);
return handler
? handler(setting)
: Promise.reject(new Error(`No visible browser viewport handler for tab ${tabId}`));
});
// The queue follows the real handler lifetime, while the caller-facing
// timeout starts only once this commit reaches the front of that queue.
const result = started.then(({ operation }) => runHandlerWithTimeout(tabId, operation));
return result;
}