Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import type { Session } from '@/lib/ccAgent.types';
import { projectKeyComparisonKey } from '../../../../shared/projectKeys';
import { sessionActivityMs } from './dateSessionGrouping';
import {
filterPersistentLocalProjectsByLastActivity,
groupSessions,
projectIdentityKeyForSession,
type PersistentLocalProject,
} from './projectGrouping';
import { isProjectHidden } from './sidebarProjectVisibility';
type SidebarProjectRestoreHandler = (projectKey: string) => Promise<boolean>;
let sidebarProjectRestoreHandler: SidebarProjectRestoreHandler | null = null;
function findMatchingProjectKey(
projectKey: string,
candidates: ReadonlySet<string>,
localPlatform: string,
): string | null {
const comparisonKey = projectKeyComparisonKey(projectKey, localPlatform);
if (comparisonKey == null) return null;
return (
Array.from(candidates).find(
(candidate) => projectKeyComparisonKey(candidate, localPlatform) === comparisonKey,
) ?? null
);
}
/**
* The sidebar owns both the hidden-project snapshot and the active Project
* filter. Creation routes live in a sibling React tree, so they delegate the
* restore transaction here instead of duplicating those two pieces of state.
*/
export function registerSidebarProjectRestoreHandler(
handler: SidebarProjectRestoreHandler,
): () => void {
sidebarProjectRestoreHandler = handler;
return () => {
if (sidebarProjectRestoreHandler === handler) sidebarProjectRestoreHandler = null;
};
}
export function requestSidebarProjectRestore(projectKey: string): Promise<boolean> {
const handler = sidebarProjectRestoreHandler;
return handler?.(projectKey) ?? Promise.resolve(false);
}
type RestoreVendorPredicate = (session: { agentKind?: string | null }) => boolean;
interface CollectRestorableProjectKeysOptions {
sessions: readonly Session[];
provisionalDraftTaskId?: string | null;
persistentLocalProjects?: readonly PersistentLocalProject[];
lastActivityCutoff: number | null;
pinnedProjectKeys: ReadonlySet<string>;
vendorPredicate: RestoreVendorPredicate | null;
localPlatform?: string;
}
/**
* Returns project keys that can actually appear in the current renderer after
* the hidden overlay and explicit Project filter are removed.
*
* Callers provide sessions already scoped by machine, status, and Orca role.
* Vendor and activity filters mirror the sidebar selectors. Individually
* pinned sessions and pinned projects keep the sidebar's existing behavior of
* bypassing the last-activity cutoff.
*/
export function collectRestorableProjectKeys({
sessions,
provisionalDraftTaskId,
persistentLocalProjects = [],
lastActivityCutoff,
pinnedProjectKeys,
vendorPredicate,
localPlatform = '',
}: CollectRestorableProjectKeysOptions): ReadonlySet<string> {
const vendorSessions = vendorPredicate ? sessions.filter(vendorPredicate) : sessions;
const vendorProjects = vendorPredicate
? persistentLocalProjects.filter(
(project) =>
project.knownAgentKinds.length === 0 ||
project.knownAgentKinds.some((agentKind) => vendorPredicate({ agentKind })),
)
: persistentLocalProjects;
const activitySessions =
lastActivityCutoff === null
? vendorSessions
: vendorSessions.filter((session) => sessionActivityMs(session) >= lastActivityCutoff);
const activityProjects = filterPersistentLocalProjectsByLastActivity(
vendorProjects,
lastActivityCutoff,
);
const activityGroups = groupSessions(activitySessions, {
provisionalDraftTaskId,
includePinnedInProjects: true,
persistentLocalProjects: activityProjects,
localPlatform,
});
const allGroups = groupSessions(sessions, {
provisionalDraftTaskId,
includePinnedInProjects: true,
persistentLocalProjects,
localPlatform,
});
const projectKeys = new Set(activityGroups.projects.map((project) => project.projectKey));
const pinnedComparisonKeys = new Set(
Array.from(pinnedProjectKeys)
.map((projectKey) => projectKeyComparisonKey(projectKey, localPlatform))
.filter((projectKey): projectKey is string => projectKey != null),
);
for (const project of allGroups.projects) {
const comparisonKey = projectKeyComparisonKey(project.projectKey, localPlatform);
if (comparisonKey != null && pinnedComparisonKeys.has(comparisonKey)) {
projectKeys.add(project.projectKey);
}
}
for (const session of allGroups.pinned) {
if (session.workspaceKind === 'dialogue') continue;
const projectKey = projectIdentityKeyForSession(session);
if (projectKey != null) projectKeys.add(projectKey);
}
return projectKeys;
}
interface RestoreHiddenProjectIfPresentOptions {
projectKey: string;
/** Whether this project was hidden before the directory picker opened. */
wasHiddenAtPickerOpen: boolean;
setProjectHidden: (projectKey: string, hidden: boolean) => Promise<boolean>;
getCurrentProjectKeys: () => ReadonlySet<string>;
ensureProjectIncluded: (projectKey: string) => void;
localPlatform: string;
}
/**
* Restores an existing hidden project after the directory picker resolves.
*
* The project catalogue is read only after the main-process update completes:
* tasks may have moved or disappeared while the picker or IPC request was open.
* The picker-open snapshot distinguishes a normal visible-project selection
* from a concurrent restore whose main-process update already became a no-op.
* Returning false tells the caller to continue with normal draft creation.
*/
export async function restoreHiddenProjectIfPresent({
projectKey,
wasHiddenAtPickerOpen,
setProjectHidden,
getCurrentProjectKeys,
ensureProjectIncluded,
localPlatform,
}: RestoreHiddenProjectIfPresentOptions): Promise<boolean> {
const hiddenStateChanged = await setProjectHidden(projectKey, false);
if (!hiddenStateChanged && !wasHiddenAtPickerOpen) {
return false;
}
const currentProjectKey = findMatchingProjectKey(
projectKey,
getCurrentProjectKeys(),
localPlatform,
);
if (currentProjectKey == null) return false;
// A restored project must also be admitted by an explicit Project filter.
// This operation is idempotent, unlike the user-facing filter toggle.
ensureProjectIncluded(currentProjectKey);
return true;
}
interface RestoreSelectedHiddenProjectOptions {
projectKey: string;
hiddenProjectKeys: ReadonlySet<string>;
setProjectHidden: (projectKey: string, hidden: boolean) => Promise<boolean>;
getCurrentProjectKeys: () => ReadonlySet<string>;
ensureProjectIncluded: (projectKey: string) => void;
localPlatform: string;
}
/**
* Restore a project explicitly selected from the new-task folder picker.
*
* Unlike the old sidebar "New Project" action, selection must continue into
* the draft after restoring. The chosen path itself is therefore the future
* project key even when the restored project currently has no visible tasks.
* Every explicit selection is admitted by the current Project filter, while
* the persisted hidden-project state is only touched when the snapshot says
* this project is actually hidden.
*/
export async function restoreSelectedHiddenProject({
projectKey,
hiddenProjectKeys,
setProjectHidden,
getCurrentProjectKeys,
ensureProjectIncluded,
localPlatform,
}: RestoreSelectedHiddenProjectOptions): Promise<boolean> {
const wasHidden = isProjectHidden(projectKey, hiddenProjectKeys, localPlatform);
if (wasHidden) await setProjectHidden(projectKey, false);
ensureProjectIncluded(
findMatchingProjectKey(projectKey, getCurrentProjectKeys(), localPlatform) ?? projectKey,
);
return wasHidden;
}