The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.
Rust agent-orchestrationai-agentsai-assistantdesktopllmlocal-firstmcppersonal-aiprivacyrustsecond-braintauri
import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
import { Outlet, useNavigate } from 'react-router-dom';
import { setWalkthroughPending } from '../../components/walkthrough/AppWalkthrough';
import { useCoreState } from '../../providers/CoreStateProvider';
import { trackEvent } from '../../services/analytics';
import { userScopedStorage } from '../../store/userScopedStorage';
import { getDefaultEnabledTools, getEnabledRustToolNames } from '../../utils/toolDefinitions';
import BetaBanner from './components/BetaBanner';
import { OnboardingContext, type OnboardingDraft } from './OnboardingContext';
/**
* Full-page chrome for the onboarding flow. Hosts the shared draft + the
* completion side-effects (persist `onboarding_completed`, notify backend,
* navigate to /chat). Individual steps render through `<Outlet />`.
*/
/** Where the in-progress draft is parked between reloads. */
const DRAFT_STORAGE_KEY = 'onboarding_draft';
const OnboardingLayout = () => {
const navigate = useNavigate();
const { setOnboardingCompletedFlag, setOnboardingTasks, snapshot } = useCoreState();
const [draft, setDraftState] = useState<OnboardingDraft>({ connectedSources: [] });
// The draft used to live only in React state, so a reload mid-wizard lost
// every choice and the gate sent the user back to step one. It is per-user
// state, so it goes through `userScopedStorage` rather than raw localStorage.
const draftLoaded = useRef(false);
useEffect(() => {
let cancelled = false;
void userScopedStorage
.getItem(DRAFT_STORAGE_KEY)
.then(raw => {
if (cancelled || !raw) return;
const parsed = JSON.parse(raw) as OnboardingDraft;
if (parsed && Array.isArray(parsed.connectedSources)) {
setDraftState(parsed);
}
})
.catch(e => console.debug('[onboarding:layout] no resumable draft', e))
.finally(() => {
if (!cancelled) draftLoaded.current = true;
});
return () => {
cancelled = true;
};
}, []);
// Only persist after the restore has settled, so an empty initial state
// cannot overwrite a saved draft before it is read back.
useEffect(() => {
if (!draftLoaded.current) return;
void userScopedStorage.setItem(DRAFT_STORAGE_KEY, JSON.stringify(draft));
}, [draft]);
const setDraft = useCallback(
(updater: (prev: OnboardingDraft) => OnboardingDraft) => setDraftState(updater),
[]
);
const completeAndExit = useCallback(async () => {
console.debug('[onboarding:layout] completeAndExit', {
connectedSources: draft.connectedSources,
});
try {
// Preserve a tool preference the user already customized (e.g. via
// Settings → Tools or an earlier onboarding run) rather than resetting
// to catalog defaults on every completion. Re-applying defaults here
// could silently narrow an existing selection. Only seed defaults when
// no preference has been persisted yet. The Rust-side filter
// (`filter_tools_by_user_preference`) is the authoritative guard against
// stale snapshots stripping newer tools (issue #3096); this is
// defense-in-depth on the write path.
const existingEnabledTools = snapshot.localState.onboardingTasks?.enabledTools;
const enabledTools =
existingEnabledTools && existingEnabledTools.length > 0
? existingEnabledTools
: getEnabledRustToolNames(getDefaultEnabledTools());
await setOnboardingTasks({
accessibilityPermissionGranted:
snapshot.localState.onboardingTasks?.accessibilityPermissionGranted ?? false,
enabledTools,
connectedSources: draft.connectedSources,
updatedAtMs: Date.now(),
});
} catch (e) {
console.warn('[onboarding] Failed to persist onboarding tasks; continuing completion', e);
}
try {
await setOnboardingCompletedFlag(true);
} catch (e) {
// Rethrown so the calling step can offer a retry. The draft stays in
// storage, so a retry — or a reload — resumes instead of starting over.
console.error('[onboarding] Failed to persist onboarding_completed', e);
throw e;
}
// Fire onboarding_complete analytics event before navigation.
trackEvent('onboarding_complete');
// Flag the Joyride walkthrough as pending so it auto-starts on the chat landing surface.
// Best-effort: localStorage failures must not block navigation.
try {
setWalkthroughPending();
console.debug('[onboarding:layout] walkthrough pending flag set — navigating to /chat');
} catch (e) {
console.warn('[onboarding:layout] could not set walkthrough pending flag; continuing', e);
}
// The run is finished; drop the resumable draft so a later visit to
// onboarding does not inherit stale choices. Deliberately NOT awaited:
// `userScopedStorage` blocks on the boot-time `primeActiveUserId()`, so
// awaiting it would put a storage handshake on the critical path to /chat
// and hang the final step if that prime never happened. A stale draft is
// harmless — the onboarding gate will not route back here once
// `onboarding_completed` is set — so cleanup is best-effort.
void userScopedStorage
.removeItem(DRAFT_STORAGE_KEY)
.catch(e => console.warn('[onboarding:layout] could not clear the saved draft', e));
navigate('/chat', { replace: true });
}, [draft.connectedSources, navigate, setOnboardingCompletedFlag, setOnboardingTasks, snapshot]);
const value = useMemo(
() => ({ draft, setDraft, completeAndExit }),
[draft, setDraft, completeAndExit]
);
return (
<OnboardingContext.Provider value={value}>
<div
data-testid="onboarding-layout"
className="min-h-full relative flex items-center justify-center py-10">
<div className="relative z-10 w-full max-w-2xl mx-4">
<BetaBanner />
<Outlet />
</div>
</div>
</OnboardingContext.Provider>
);
};
export default OnboardingLayout;