Skip to content

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.

4.0 KB
Raw Blame
import {
  DESKTOP_ONBOARDING_STEPS,
  type DesktopOnboardingDraft,
  type DesktopOnboardingStep,
} from "./desktopOnboardingDraft";

export { englishOnboardingTranslate, type OnboardingTranslate } from "./onboardingTranslate";

export {
  clearDesktopOnboardingHandoff,
  DEFAULT_DESKTOP_ONBOARDING_DRAFT,
  DESKTOP_ONBOARDING_COMPLETED_STORAGE_KEY,
  DESKTOP_ONBOARDING_GOAL_MAX_LENGTH,
  DESKTOP_ONBOARDING_HANDOFF_STORAGE_KEY,
  DESKTOP_ONBOARDING_LEGACY_HANDOFF_STORAGE_KEY,
  DESKTOP_ONBOARDING_STEPS,
  DESKTOP_ONBOARDING_STORAGE_KEY,
  type DesktopOnboardingDraft,
  type DesktopOnboardingStep,
  type DesktopOnboardingStepDefinition,
  markDesktopOnboardingCompleted,
  markDesktopOnboardingHandoffStarted,
  parseDesktopOnboardingDraft,
  readDesktopOnboardingDraft,
  readDesktopOnboardingHandoff,
  readDesktopOnboardingHandoffForEnvironment,
  writeDesktopOnboardingDraft,
} from "./desktopOnboardingDraft";

export {
  type DesktopOnboardingCreationReadiness,
  desktopOnboardingModelSelection,
  resolveDesktopOnboardingCreationReadiness,
  resolveDesktopOnboardingEngine,
} from "./desktopOnboardingEngine";

export {
  canStartDesktopOnboardingReveal,
  DESKTOP_ONBOARDING_CELEBRATION_PIECES,
  DESKTOP_ONBOARDING_DESTINATION_TIMEOUT_MS,
  DESKTOP_ONBOARDING_HANDOFF_PHASES,
  DESKTOP_ONBOARDING_HANDOFF_STAGES,
  DESKTOP_ONBOARDING_REVEAL_DURATION_MS,
  type DesktopOnboardingCelebrationPiece,
  desktopOnboardingCelebrationPieces,
  desktopOnboardingDestinationReady,
  desktopOnboardingHandoffAvatarState,
  desktopOnboardingHandoffDurationMs,
  type DesktopOnboardingHandoffPhase,
  type DesktopOnboardingHandoffStage,
  desktopOnboardingHandoffStages,
  desktopOnboardingHandoffStatus,
  desktopOnboardingHandoffStatuses,
} from "./desktopOnboardingHandoff";

/**
 * Short label for the goal, shown live in the preview while the user is still
 * typing. Collapses newlines so a multi-line answer still reads on one line.
 */
export function resolveDesktopOnboardingFocusLabel(goal: string): string | null {
  const summary = goal.trim().replace(/\s+/g, " ");

  if (summary.length === 0) return null;

  return summary.length > 48 ? `${summary.slice(0, 47).trimEnd()}…` : summary;
}

export function shouldShowDesktopOnboarding(input: {
  readonly desktop: boolean;
  readonly rosterLoaded: boolean;
  readonly serverBotCount: number;
  readonly draft: DesktopOnboardingDraft | null;
  readonly completed: boolean;
  readonly started: boolean;
}): boolean {
  if (!input.desktop || !input.rosterLoaded) return false;

  return input.started || input.draft !== null || (!input.completed && input.serverBotCount === 0);
}

export function recoverMissingDesktopOnboardingBot(
  draft: DesktopOnboardingDraft,
  serverBotIds: readonly string[],
): DesktopOnboardingDraft {
  if (draft.step !== "message" || draft.botId === null || serverBotIds.includes(draft.botId)) {
    return draft;
  }

  return { ...draft, step: "identity", botId: null };
}

export function recoverDisappearedDesktopOnboardingBot(
  draft: DesktopOnboardingDraft,
  readyBotId: string | null,
): DesktopOnboardingDraft {
  if (draft.step !== "message" || draft.botId === null || draft.botId !== readyBotId) return draft;

  return { ...draft, step: "identity", botId: null };
}

export function stepNumber(step: DesktopOnboardingStep): number {
  const index = DESKTOP_ONBOARDING_STEPS.findIndex((candidate) => candidate.id === step);

  return index === -1 ? DESKTOP_ONBOARDING_STEPS.length : index + 1;
}

export interface DesktopOnboardingProgress {
  readonly number: number;
  readonly total: number;
  /** 0 on the first step, 1 once the last one is reached. */
  readonly fraction: number;
  readonly label: string;
}

export function desktopOnboardingProgress(step: DesktopOnboardingStep): DesktopOnboardingProgress {
  const total = DESKTOP_ONBOARDING_STEPS.length;
  const number = stepNumber(step);

  return {
    number,
    total,
    fraction: total <= 1 ? 1 : (number - 1) / (total - 1),
    label: `Step ${number} of ${total}`,
  };
}