Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* Renderer 本地 provider 快照存储。
*
* 状态与 React hook 分离,供 localCatalogSnapshot 原子提交 providers 与两份
* agent capabilities;这样 useProviders.refetch 可以复用联合刷新而不形成循环依赖。
*/
import type { ProviderView } from '@cindy/model-providers';
import {
getDataOwnerGeneration,
isDataOwnerGenerationCurrent,
type DataOwnerGeneration,
} from '@/contexts/dataOwnerGeneration';
interface ProvidersRefreshToken {
generation: number;
owner: DataOwnerGeneration;
}
export interface ProvidersSnapshot {
dataOwnerId: string | null;
/** Main app-session generation that leases owner-scoped provider writes. */
ownerGeneration: number;
providers: ProviderView[];
providerOrder: string[];
}
let cachedProviders: ProvidersSnapshot | null = null;
let providersGeneration = 0;
let failedRefresh: ProvidersRefreshToken | null = null;
const providerListeners = new Set<(snapshot: ProvidersSnapshot | null) => void>();
/** Failure is scoped to the latest refresh and owner; absence of a snapshot alone is not progress. */
export function hasProvidersSnapshotLoadFailed(): boolean {
return failedRefresh !== null && isProvidersRefreshCurrent(failedRefresh);
}
export function failProvidersRefresh(token: ProvidersRefreshToken): void {
if (!isProvidersRefreshCurrent(token)) return;
failedRefresh = token;
for (const listener of providerListeners) listener(getCachedProvidersSnapshot());
}
/** 返回当前 data owner 最近一次完整 provider 快照;未加载或归属不符时为 null。 */
export function getCachedProvidersSnapshot(): ProvidersSnapshot | null {
const { dataOwnerId } = getDataOwnerGeneration();
return cachedProviders?.dataOwnerId === dataOwnerId ? cachedProviders : null;
}
/** 订阅完整 provider 快照提交。 */
export function subscribeProvidersSnapshot(
listener: (snapshot: ProvidersSnapshot | null) => void,
): () => void {
providerListeners.add(listener);
return () => providerListeners.delete(listener);
}
/** Owner 切换时同步清空旧快照,并通知已挂载的消费者立即隐藏旧 owner 数据。 */
export function invalidateProvidersSnapshot(): void {
failedRefresh = null;
cachedProviders = null;
providersGeneration += 1;
for (const listener of providerListeners) listener(null);
}
/** 为一次 provider 快照读取分配代际;更早请求完成后不得再覆盖缓存。 */
export function beginProvidersRefresh(): ProvidersRefreshToken {
const wasFailed = hasProvidersSnapshotLoadFailed();
failedRefresh = null;
providersGeneration += 1;
if (wasFailed) {
for (const listener of providerListeners) listener(getCachedProvidersSnapshot());
}
return {
generation: providersGeneration,
owner: getDataOwnerGeneration(),
};
}
/** 读取 provider 快照。失败向上抛,由联合刷新保留上一份有效缓存。 */
export async function loadProvidersSnapshot(): Promise<ProvidersSnapshot> {
const result = await window.electronAPI.maker.listProviders();
return {
dataOwnerId: result.dataOwnerId,
ownerGeneration: result.ownerGeneration,
providers: result.providers,
providerOrder: result.providerOrder,
};
}
export function isProvidersRefreshCurrent(
token: ProvidersRefreshToken,
snapshot?: ProvidersSnapshot,
): boolean {
return (
providersGeneration === token.generation
&& isDataOwnerGenerationCurrent(token.owner)
&& (snapshot === undefined || snapshot.dataOwnerId === token.owner.dataOwnerId)
);
}
/** 仅提交当前代际的完整快照,并一次通知所有 mounted hooks。 */
export function commitProvidersSnapshot(
token: ProvidersRefreshToken,
next: ProvidersSnapshot,
): boolean {
if (!isProvidersRefreshCurrent(token, next)) return false;
failedRefresh = null;
cachedProviders = next;
for (const listener of providerListeners) listener(next);
return true;
}
export const __testing = {
reset(): void {
failedRefresh = null;
cachedProviders = null;
providersGeneration = 0;
},
};