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 * as Predicate from "effect/Predicate";
import { Debouncer } from "@tanstack/react-pacer";
export interface StateStorage<R = unknown> {
getItem: (name: string) => string | null | Promise<string | null>;
setItem: (name: string, value: string) => R;
removeItem: (name: string) => R;
}
export interface DebouncedStorage<R = unknown> extends StateStorage<R> {
flush: () => void;
}
export function createMemoryStorage(): StateStorage {
const store = new Map<string, string>();
return {
getItem: (name) => store.get(name) ?? null,
setItem: (name, value) => {
store.set(name, value);
},
removeItem: (name) => {
store.delete(name);
},
};
}
export function isStateStorage(
storage: Partial<StateStorage> | null | undefined,
): storage is StateStorage {
return (
storage !== null &&
storage !== undefined &&
Predicate.isFunction(storage.getItem) &&
Predicate.isFunction(storage.setItem) &&
Predicate.isFunction(storage.removeItem)
);
}
export function resolveStorage(storage: Partial<StateStorage> | null | undefined): StateStorage {
return isStateStorage(storage) ? storage : createMemoryStorage();
}
export function createDebouncedStorage(
baseStorage: Partial<StateStorage> | null | undefined,
debounceMs: number = 300,
): DebouncedStorage {
const resolvedStorage = resolveStorage(baseStorage);
const debouncedSetItem = new Debouncer(
(name: string, value: string) => {
resolvedStorage.setItem(name, value);
},
{ wait: debounceMs },
);
return {
getItem: (name) => resolvedStorage.getItem(name),
setItem: (name, value) => {
debouncedSetItem.maybeExecute(name, value);
},
removeItem: (name) => {
debouncedSetItem.cancel();
resolvedStorage.removeItem(name);
},
flush: () => {
debouncedSetItem.flush();
},
};
}