perf: overhaul session loading, caching, and runtime isolation (#2360)

Improve OpenChamber responsiveness under large session workloads while fixing
cache, synchronization, and persistence correctness across runtimes, projects,
directories, and worktrees.

- prioritize selected and visible sessions during bootstrap and defer
  non-critical enrichment work
- reduce redundant message loading, event processing, store publication, and
  hidden sidebar work
- prevent stale session and message requests from overwriting newer
  authoritative state
- preserve existing data when authoritative fetches fail instead of treating
  failures as successful empty responses
- scope session materialization, messages, drafts, queues, todos, pins,
  permissions, folders, tabs, Git state, and pull request data by runtime and
  directory identity
- harden runtime switching, reconnect, cleanup, mutation reconciliation, and
  persisted-state ordering
- preserve live subagent Task linkage when metadata arrives after an older
  message request or while streaming parts are suspended
- coalesce overlapping tail refreshes without losing newer refresh demand
- improve cold-session loading by moving deferrable work out of the critical
  bootstrap path
- isolate URL authentication, mobile credentials, native secrets, and other
  runtime-owned state across endpoint changes
- bound long-lived caches and remove avoidable allocations from event and
  rendering hot paths
- limit virtualization to archive collections where it improves rendering
  without disrupting active sidebar layout
- stabilize session folders, pin ordering, expanded state, and persisted
  sidebar behavior
- open skill files through the same secure editor and outside-workspace grant
  flow used by file navigation, including worktree sessions
- expand regression coverage for stale completions, runtime collisions,
  reconnect behavior, persistence races, authoritative empty results, and
  subagent refresh ordering
- document the updated synchronization, cache ownership, performance, and
  runtime-isolation invariants
This commit is contained in:
Bohdan Triapitsyn
2026-07-21 20:52:20 +03:00
committed by GitHub
parent 485efc7117
commit 85400459e9
197 changed files with 10835 additions and 3400 deletions
+90 -37
View File
@@ -3,6 +3,8 @@ import { devtools, persist } from 'zustand/middleware';
import { createDeferredSafeJSONStorage } from './utils/safeStorage';
import type { AttachedFile } from './types/sessionTypes';
import { updateDesktopSettings } from '@/lib/persistence';
import { getRuntimeKey } from '@/lib/runtime-switch';
import { normalizePath } from '@/lib/pathNormalization';
export type FollowUpBehavior = 'steer' | 'queue';
@@ -52,38 +54,82 @@ export interface QueuedMessage {
};
}
export type MessageQueueTarget = {
runtimeKey: string;
directory: string;
sessionId: string;
};
const MAX_QUEUE_TARGETS = 50;
const MAX_MESSAGES_PER_QUEUE = 20;
export const createMessageQueueTarget = (
sessionId: string,
directory: string | null | undefined,
runtimeKey: string = getRuntimeKey(),
): MessageQueueTarget | null => {
const normalizedDirectory = normalizePath(directory);
if (!runtimeKey || !normalizedDirectory || !sessionId) return null;
return { runtimeKey, directory: normalizedDirectory, sessionId };
};
export const getMessageQueueKey = (target: MessageQueueTarget): string =>
`${target.runtimeKey}\n${target.directory}\n${target.sessionId}`;
export const parseMessageQueueKey = (key: string): MessageQueueTarget | null => {
const [runtimeKey, directory, ...sessionParts] = key.split('\n');
return createMessageQueueTarget(sessionParts.join('\n'), directory, runtimeKey);
};
interface MessageQueueState {
queuedMessages: Record<string, QueuedMessage[]>; // sessionId → queue
queuedMessages: Record<string, QueuedMessage[]>; // runtime + directory + session → queue
quarantinedLegacyMessages: Record<string, QueuedMessage[]>;
followUpBehavior: FollowUpBehavior;
}
interface MessageQueueActions {
addToQueue: (sessionId: string, message: Omit<QueuedMessage, 'id' | 'createdAt'>) => void;
removeFromQueue: (sessionId: string, messageId: string) => void;
reorderQueue: (sessionId: string, fromId: string, toId: string) => void;
popToInput: (sessionId: string, messageId: string) => QueuedMessage | null;
clearQueue: (sessionId: string) => void;
addToQueue: (target: MessageQueueTarget, message: Omit<QueuedMessage, 'id' | 'createdAt'>) => void;
removeFromQueue: (target: MessageQueueTarget, messageId: string) => void;
reorderQueue: (target: MessageQueueTarget, fromId: string, toId: string) => void;
popToInput: (target: MessageQueueTarget, messageId: string) => QueuedMessage | null;
clearQueue: (target: MessageQueueTarget) => void;
clearAllQueues: () => void;
setFollowUpBehavior: (behavior: FollowUpBehavior) => void;
getQueueForSession: (sessionId: string) => QueuedMessage[];
getQueueForTarget: (target: MessageQueueTarget) => QueuedMessage[];
}
type MessageQueueStore = MessageQueueState & MessageQueueActions;
type PersistedMessageQueueState = {
queuedMessages?: Record<string, QueuedMessage[]>;
quarantinedLegacyMessages?: Record<string, QueuedMessage[]>;
followUpBehavior?: FollowUpBehavior;
queueModeEnabled?: boolean;
};
export const migrateMessageQueueState = (persistedState: unknown, version: number): Partial<MessageQueueStore> => {
const state = (persistedState ?? {}) as PersistedMessageQueueState;
const legacyQueues = version < 2 ? (state.queuedMessages ?? {}) : {};
return {
queuedMessages: version < 2 ? {} : (state.queuedMessages ?? {}),
quarantinedLegacyMessages: {
...(state.quarantinedLegacyMessages ?? {}),
...legacyQueues,
},
followUpBehavior: normalizeFollowUpBehavior(state.followUpBehavior, state.queueModeEnabled ?? null),
};
};
export const useMessageQueueStore = create<MessageQueueStore>()(
devtools(
persist(
(set, get) => ({
queuedMessages: {},
quarantinedLegacyMessages: {},
followUpBehavior: DEFAULT_FOLLOW_UP_BEHAVIOR,
addToQueue: (sessionId, message) => {
addToQueue: (target, message) => {
const key = getMessageQueueKey(target);
const id = `queued-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
const queuedMessage: QueuedMessage = {
id,
@@ -94,23 +140,32 @@ export const useMessageQueueStore = create<MessageQueueStore>()(
};
set((state) => {
const currentQueue = state.queuedMessages[sessionId] ?? [];
const currentQueue = state.queuedMessages[key] ?? [];
const queuedMessages = {
...state.queuedMessages,
[key]: [...currentQueue, queuedMessage].slice(-MAX_MESSAGES_PER_QUEUE),
};
const keys = Object.keys(queuedMessages);
if (keys.length > MAX_QUEUE_TARGETS) {
keys.sort((left, right) => (
(queuedMessages[left]?.[0]?.createdAt ?? 0) - (queuedMessages[right]?.[0]?.createdAt ?? 0)
));
for (const staleKey of keys.slice(0, keys.length - MAX_QUEUE_TARGETS)) delete queuedMessages[staleKey];
}
return {
queuedMessages: {
...state.queuedMessages,
[sessionId]: [...currentQueue, queuedMessage],
},
queuedMessages,
};
});
},
removeFromQueue: (sessionId, messageId) => {
removeFromQueue: (target, messageId) => {
const key = getMessageQueueKey(target);
set((state) => {
const currentQueue = state.queuedMessages[sessionId] ?? [];
const currentQueue = state.queuedMessages[key] ?? [];
const newQueue = currentQueue.filter((m) => m.id !== messageId);
if (newQueue.length === 0) {
const { [sessionId]: _removed, ...rest } = state.queuedMessages;
const { [key]: _removed, ...rest } = state.queuedMessages;
void _removed;
return { queuedMessages: rest };
}
@@ -118,16 +173,17 @@ export const useMessageQueueStore = create<MessageQueueStore>()(
return {
queuedMessages: {
...state.queuedMessages,
[sessionId]: newQueue,
[key]: newQueue,
},
};
});
},
reorderQueue: (sessionId, fromId, toId) => {
reorderQueue: (target, fromId, toId) => {
if (fromId === toId) return;
const key = getMessageQueueKey(target);
set((state) => {
const currentQueue = state.queuedMessages[sessionId];
const currentQueue = state.queuedMessages[key];
if (!currentQueue) return state;
const fromIndex = currentQueue.findIndex((m) => m.id === fromId);
const toIndex = currentQueue.findIndex((m) => m.id === toId);
@@ -140,15 +196,16 @@ export const useMessageQueueStore = create<MessageQueueStore>()(
return {
queuedMessages: {
...state.queuedMessages,
[sessionId]: newQueue,
[key]: newQueue,
},
};
});
},
popToInput: (sessionId, messageId) => {
popToInput: (target, messageId) => {
const key = getMessageQueueKey(target);
const state = get();
const currentQueue = state.queuedMessages[sessionId] ?? [];
const currentQueue = state.queuedMessages[key] ?? [];
const message = currentQueue.find((m) => m.id === messageId);
if (!message) {
@@ -157,11 +214,11 @@ export const useMessageQueueStore = create<MessageQueueStore>()(
// Remove from queue
set((prevState) => {
const queue = prevState.queuedMessages[sessionId] ?? [];
const queue = prevState.queuedMessages[key] ?? [];
const newQueue = queue.filter((m) => m.id !== messageId);
if (newQueue.length === 0) {
const { [sessionId]: _removed, ...rest } = prevState.queuedMessages;
const { [key]: _removed, ...rest } = prevState.queuedMessages;
void _removed;
return { queuedMessages: rest };
}
@@ -169,7 +226,7 @@ export const useMessageQueueStore = create<MessageQueueStore>()(
return {
queuedMessages: {
...prevState.queuedMessages,
[sessionId]: newQueue,
[key]: newQueue,
},
};
});
@@ -177,9 +234,10 @@ export const useMessageQueueStore = create<MessageQueueStore>()(
return message;
},
clearQueue: (sessionId) => {
clearQueue: (target) => {
const key = getMessageQueueKey(target);
set((state) => {
const { [sessionId]: _removed, ...rest } = state.queuedMessages;
const { [key]: _removed, ...rest } = state.queuedMessages;
void _removed;
return { queuedMessages: rest };
});
@@ -194,25 +252,20 @@ export const useMessageQueueStore = create<MessageQueueStore>()(
void updateDesktopSettings({ followUpBehavior: behavior });
},
getQueueForSession: (sessionId) => {
return get().queuedMessages[sessionId] ?? [];
getQueueForTarget: (target) => {
return get().queuedMessages[getMessageQueueKey(target)] ?? [];
},
}),
{
name: 'message-queue-store',
version: 1,
version: 2,
storage: createDeferredSafeJSONStorage(),
partialize: (state) => ({
queuedMessages: state.queuedMessages,
quarantinedLegacyMessages: state.quarantinedLegacyMessages,
followUpBehavior: state.followUpBehavior,
}),
migrate: (persistedState) => {
const state = (persistedState ?? {}) as PersistedMessageQueueState;
return {
queuedMessages: state.queuedMessages ?? {},
followUpBehavior: normalizeFollowUpBehavior(state.followUpBehavior, state.queueModeEnabled ?? null),
};
},
migrate: migrateMessageQueueState,
}
),
{